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INTRODUCTION 


This document describes programming of the NINTENDO ENTERTAINMENT 
SYSTEM (NES) for game programmers. Thorough knowledge of the 6502 CPU and 
general principles of graphics and sound programming are prerequisites to 
understanding this document. 


The entire contents of this document were discovered by the author through reverse 
engineering. The bulk of this work was done by disassembling and commenting the 
contents of several NES cartridges. Schematics of the hardware were drawn and 
with the aid of an oscilloscope and a logic analyzer the remaining functional facts 
were arrived at. Certain operating characteristics were then tested and verified 
through custom programs and alteration of existing programs. 


This document was prepared entirely by the author with some feedback from field 
testers ee this information. The author has had no access to documentation or 
consultation from employees or affiliates of NINTENDO of America or their 
Japanese counterpart. Because of the speculative nature of the information 
contained herein, no guarantees are given nor implied about the accuracy of this 
document. The author has, however, made a reasonable effort to verify all facts in 
this document through test programs. 
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THE HARDWARE 


The NES is a dedicated game computer. It has a dual bus architecture. The Central 
Processing Unit (CPU) is a custom chip emulating a 6502 and controls the first bus. 
The Picture Processing Unit (PPU) is a custom graphics controller not emulating 
any graphics chip known to me. The PPU controls the second bus. Communications 
between the two processors is controlled by the CPU which can read and write to 
the PPU. 


The CPU is 100% software compatible with the basic 6502. It does not support any 
extensions of the instructions set, such as found in the 65C02. On the hardware side 
it is not pin compatible and doesn't use all the signals the original 6502 does. The 
CPU also includes a multi channel wave synthesizer for music and sound effects. It 
is logically mapped into the CPU's address space at $4000 - $SFFF. The CPU 
includes dedicated I/O pins sr Satie controller interfacing. 2K bytes of static RAM 
are mapped to $0000 - $07FF. The RAM is used for zero page storage, the stack and 
general variable usage. The PPU interface is mapped to $2000 - $3FFF. The CPU 
communicates with the PPU through this address range which contains several 
dedicated PPU registers. Because of the dual bus nature of the system no cycles are 
stolen from the CPU during the visible portion of the display cycle, resulting in true 
1.79 MHz operation. 


The rest of the memory space is mapped to the cartridge. Area $6000 - $7FFF is 
reserved for optional CPU RAM that a ota may contain. Area $8000 - $FFFF 
is reserved for the programs to be executed. Since all programs are contained in 
Saher to this area are used to perform cartridge specific tasks such as bank 
switching. 


The PPU is a graphics display chip handling the physical displaying of information. 
It gets instructions from the CPU during a brief interval in the NMI service routine 
and operates autonomously thereafter refreshing the display. The motherboard 
contains 2K bytes of static RAM used as screen memory. The screen memory area is 
mapped to $2000 - $2FFF, allowing a total of 4 separate screens. Because the 
existing 2K only allows 2 full screens some of the screen address selection logic is 
handled on the cartridge which decides on horizontal or vertical scrolling and may 
even add an extra 2K for true diagonal scrolling. Area $0000 - SIFFF on the 
cartridge may contain RAM or ROM for background and sprite definitions. This 
area may contain bank switched memory which is switched by the CPU. 


The PPU generates character based screens and supports sprites. There are no 
signals generated for the CPU to allow for line interrupts, the only signal generated 
is a vblank signal that is used as an NMI on the CPU. All dynamic display changes 
must be handled through exact cycle counting with the CPU. Sprites are defined in 
vblank and also cannot be altered dynamically during the visible cycle of a screen 
refresh. The PPU is clocked by a master clock at 21 Mhz which generates all video 
clocking signals and feeds an R/F modulator. 
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The motherboard has no provisions for on board expansion of memory. It does have 
a separate edge connector on the bottom giving access to many but not all signals. I 
have never encountered a product using this expansion connector. 


A security chip fed by a 4 MHz clock generates a signature that communicates with 
cartridges. Unless a cartridge responds with the proper signature in return the 
security chip enables the reset lines to both CPU and PPU and resends the signature 
periodically. This causes a blank screen to be displayed when no cartridge is inserted 
and also ensures that every cartridge must contain an NES proprietary security chip. 
The motherboard contains no ROM. 


The entire unit is housed in a plastic box with insufficient ventilation. A cartridge 
running several hours generates a lot of damaging heat. One very effective solution 
to this is removing the cartridge door from the NES console. This results in 
increased airflow and a significant reduction in ambient cartridge temperature. 
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GRAPHICS PROGRAMMING 


The NES has a character based screen and includes sprite support. Memory areas 
for the PPU include screen memory on the motherboard and background and sprite 
character definition memory on the cartridge. The CPU communicates with the 
PPU through several PPU ogi mapped into the CPU's address space. The CPU 
can access PPU memory only through communicating with the PPU, not directly 
because of separate buses. 


SCREEN MEMORY 


A full NES screen consists of 32 characters across by 30 characters high. Each 
character is eight pet square yielding a total resolution of 256 x 240 pixels. This 
uses up a total of 960 bytes per character screen. The NES doesn't use a blank 
overscan area, the characters fill the entire physical viewing area of the screen. 
Because of this you might lose some display information depending on the 
particular display model used. I have displayed worst case display loss on a 
Commodore 1702 video monitor. You lose about 1 1/2 lines form the top, 1 line 
from the bottom and parts of the left and right borders due to screen curvature. 
Losses are less severe on regular television screens which most NES game players 
use. 


Screen memory is followed by 64 bytes of background color memory for a total of 
1K Bytes per screen. Therefore internal memory allows a total of two full screens to 
be stored, and the screens are mapped as follows: 


$2000 - $23BF Screen 1 character map 
$23C0 - $23FF Screen 1 color memory 
$2400 - $27BF Screen 2 character map 
$27CO - $27FF Screen 2 color memory 


The CPU can write data to the screen by using the PPU Memory Address Register 
(PMAR, $2006) and the PPU Memory Data Register (PMDR, $2007). Data is 
transferred by vous a base destination address to PMAR followed by byte by byte 
data writes to PMDR. The destination address can be programmed to either 
autoincrement by one (for row transfers) or autoincrement by 32 (for column 
transfers). Autoincrement mode is set through PPU Control Register 1 (PCR1, 
$2000), bit 2. Since VCR1 seems to be a write only registers it is a good idea to 
maintain a shadow register in RAM. VCR1 contains several functions and a shadow 
register allows alteration of a single function without disturbing the rest. 


Screen Pe oraay are accomplished by writing the 16 bit PPU destination address to 
PMAR (MSB first) followed by the data bytes. 


For example, to write a column of data to the third column in the display you may 
use the following code: 


sr 
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PCR1 EQU $2000 ; Video Control Reg 1 
ShPCR1 EQU) $300 + RAM shadow 
PMAR EQU $2006 ; PPU Mem Adr Reg 
PMDR EQU $2007 ; PPU Mem Data Reg 
AIRMask EQU) 4111110211 ; auto inc bit mask 
AIR1 EQU %00000000 ; inc by 1 
AIR32 EQU %00000100 ; inc by 32 
SCREEN1BASE EQU $2000 ; start of screen 1 
Ind EQU SFO ; pointer to src data 
WriteColumn LDA #>SCREEN1BASE 

STA PMAR ; store MSB of dest 

LDA #<SCREEN1Base 

CLC 

ADC #2 ; add offset 

STA PMAR ; store LSB of dest 

LDA ShVCR1 ; get shadow reg 

AND #AIRMask ; isolate bit 

OR #AIR32 ; set 32 byte mode 

STA ShPCR1 ; save shadow 

STA PCR1 ; set register Cc 

LDY #0 ; clear index 
Loop LDA (Ind) ,Y * get source data 

STA PMDR ; save to dest 

INY 

CPY #32 

BCC Loop 

RTS 


To read screen data the reverse of the above procedure could be used. Note, 
however, that the very first byte you read is invalid and should be ignored. 


For example, to read the third column of data from the display you may use the 
following code: . 


PCR1 EQU $2000 ; Video Control Reg 1 
ShPCR1 EQU $300 ; RAM shadow 

PMAR EQU $2006 ; PPU Mem Adr Reg 
PMDR EQU $2007 ; PPU Mem Data Reg 
AIRMask EQU %11111011 ; auto inc bit mask 
AIR1 EQU %00000000 ; inc by 1 

AIR32 EQU %00000100 ; inc by 32 
SCREEN1BASE EQU) $2000 ; start of screen 1 
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Ind EQU S$FO ; pointer to sre data 
ReadColumn LDA #>SCREEN1BASE 

STA PMAR. ; store MSB of dest 

LDA #<SCREEN1Base 

CLC 

ADC #2 ; add offset 

STA PMAR ; store LSB of dest 

LDA ShVCR1 ; get shadow reg 

AND #AIRMask ; isolate bit 

OR #AIR32 ; set 32 byte mode 

STA ShPCR1 ; save shadow 

STA PCR1 ; set register 

LDY #0 ; clear index 

LDA PMDR ; Giscard first byte 
Loop LDA PMDR ; get screen data 

STA (Ind) ,Y ; Save to dest 

INY 

CPY #32 

BCC Loop 

RTS 


SCROLLING 

. The screen may be fine scrolled both horizontally and vertically. ee is 
controlled through the PPU Scroll Offset Register (PSOR, $2005) and PCR1. Each: 
scroll value may be from 0 to 256. A value of 256 is specified by setting the 


respective upper scroll bit in PCR1. Values from 0 to 255 are transferred to PSOR 
through two consecutive writes, with the horizontal value written first. 


For example, to transfer scroll values to the screen you may use the following code: 


PCR1 EQU $2000 ; PPU Ctrl Reg 1 
PSOR EQU $2005 ; PPU Scroll Reg 
HScroll EQU $300 ; horiz offset 
HScrollH EQU $301 ; horiz hi bit 
vVsceroll EQU $302 ; vert offset 
VScrollH EQU $303 + vert hi bit 
DoScroll LDA HScrollH ; see if H at max 
LSR A 


; not at max 
LDA ShPCR1 ; get shadow 

; set H hi bit 

?; Save 
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DS1 LDA VScrollH ; see if V at max 
LSR A : 
BCC DS2 7; not at max 
LDA ShPCR1 +; get shadow 
ORA #2 ; set V hi bit 
STA ShnPCR1 + save shadow 

DS2 LDA ShPCR1 ; get shadow 
STA PCR1 ; into register 
LDA HScrolil * get h value 
STA PSOR ; into reg 
LDA VScroll ; get V value 
STA PSOR ; into reg 
RTS 


The NES has 4 logical screens. They are related to the visible area as follows: 


Screen #1 $2000 - $23FF Screen #2 $2400 - $27FF 


Vertical 
Scrolling 
Offset 
Horizontal 
Scrolling 
Offset Visible Screen 


Screen #3 $2800 - S$2BFF Screen #4 $2C00 - S2FFF 


EME OM tag EP ee, SR pO Be GET ST, Sy BR. aie Gama tenes F 
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Since the NES has only 2K bytes of screen memory we have available 2 physical 
screens. On most cartridge types you are given the option of how to assign physical 
screens to logical screens for scrolling purposes. This is achieved through either a 


hardware Horizontal/Vertical es on the cartridge or a special purpose chip 


which can be programmed for H/V selection. 


Physical to logical screen mapping is achieved through cartridge logic generating 


PPU address 11 for screen memory. 


-10- 
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When horizontal scrolling is selected the following mapping is in effect. Physical 
screen #1 is mapped to logical screens #1 and #3 simultaneously. Physical screen 
#2 is mapped to logical screens #2 and #4 simultaneously. Applying a horizontal 
scrolling offset will result in true scrolling from one physical screen to another. 
However, applying a vertical offset will result in the same physical screen wrapping 
around the edges. To achieve diagonal scrolling the vertical scrolling data must be 
dynamically rewritten. 


When vertical scrolling is selected the following mapping is in effect. Physical screen 
#1 is mapped to logical screens #1 and #2 simultaneously. Physical screen #2 is 
mapped to logical screens #3 and #4 simultaneously. Applying a vertical scrolling 
offset will result in true scrolling from one physical screen to another. However 
applying a horizontal offset will result in the same physical screen wrapping around 
the edges. To achieve diagonal scrolling the horizontal scrolling data must be 
dynamically rewritten. 


Some cartridges allow for character definition memory to be used as extra screen 
memory, resulting in 4 physical screens and an exact one to one mapping of logical 
to physical screens. This is a vehicle for true diagonal scrolling with a minimum of 
software overhead. 


CHARACTER SET 


Background characters consist of an 8 x 8 yea array. Each pixel can be one of four 
colors, eequining 2 bits per pixel. Therefore a total of 128 bits or 16 bytes are 
required to define a character. Characters are defined in a contiguous block of 16 
bytes. The definition is structured similar to IBM EGA graphics. The character has 
two bit planes, the first eight bytes define the first bit plane and the second eight 
bytes define the second bit plane. Consider the following character, with each 
number defining a pixel's two bit color value (0 - 3): 


00000000 
01000000 
00200000 
00030000 
00001000 
00000200 
00000030 
0123012 3 


A data statement describing this character would look like the following (using 
binary constants): 


ee 
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; first plane 
DB %00000000, 401000000, 00000000, 00010000 
DB %00001000, 00000000, 00000010, $01010101 


* second plane 
DB %0000000C, 00000000, $00100000, 00010000 
Ds %00000000, 00000100, $00000010, $00110011 


The background character set consists of 256 characters requiring a total of 4K bytes 
of memory. This memory is on the cartridge, and may be either RAM or ROM. The 
background character set may be mapped starting at $0000 or $1000. Mapping is 
controlled by PCR}, bit 4. When bit 4 = 0, the character set is mapped to $0000 - 
SOFFF, otherwise the set is mapped to $1000 - $1FFF. 


Even eng) chatertes mapping is restricted to two areas, several cartridges offer 
bank switching mechanisms for the eae ound character set memory. This allows 
you access to several different background character sets. 


A game using the above technique on a single screen is "Mickey Mouscapades'. The 
background character set is switched in the middle of the title screen to allow for a 
screen made up of more than 256 individual characters. 


SCREEN COLORS 


The NES has four color sets made up of four colors each for use by the background 
characters. Each color is described by a byte where 


Bits 3..0 - primary color 
Bits 5..4 - intensity 
Bits 7..6 - not used 


The primary colors seem to be: 


Wp CONINNARWNHO 
o 
a. 


Green/Turquoise 


ws 
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Cyan 
Gray 2 
Black 
Black 


eolulele) 


The color sets are mapped as follows: 


$3F00 color set #1 background (not used) 
$3F01 color set #1 color for bit combo 01 
$3F02 color set #1 color for bit combo 10 
$3F03 color set #1 color for bit combo 11 
$3F04 color set #2 background (not used) 
$3F05 color set #2 color for bit combo 01 
$3F06 color set #2 color for bit combo 10 
$3F07 color set #2 color for bit combo 11 
$3F08 color set #3 background (not used) 
$3F09 color set #3 color for bit combo 01 
$3F0Acolor set #3 color for bit combo 10 
$3F0B color set #3 color for bit combo 11 
$3F0C color set #4 background (not used) 
$3F0Dcolor set #4 color for bit combo 01 
$3F0E color set #4 color for bit combo 10 
$3F0F color set #4 color for bit combo 11 


To define a set of background character color sets the following code may be used. 


Ind EQU $FO 

PMAR EQU $2006 

PMDR EQU $2007 

SetColors LDA #<ColorSet 
STA Ind ; high byte of table 
LDA #>ColorSet 
STA Ind+l ? low byte of table 
LDY #0 
LDA #$3F ; high byte of dest 
STA PMAR 
LDA #0 ; lo byte of dest 
STA PMAR 

Loop LDA (Ind) ,Y ; get src 
STA PMDR ; store in PPU 
INY 
CPY #16 
BCC Loop 
RTS 


{33 
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ColorSet DB 1,2,3,4 ? color set #1 
DB 5,6,7,8 ; color set #2 
DB 1,2,3,5 ; color set #3 
DB 9,8,7,6 ; color set #4 


The screen background color is specified at location $3F 10. 


Color sets are assigned to characters as follows: First divide the screen into blocks of 
4x 4 characters starting at the top left of the screen. You will end up with 64 blocks 
with one color memory location assigned to each block. Further divide each block 
into 4 subblocks of 2 x 2 characters. Number these 1 through 4 starting at the top left 
subblock. The first character block on the screen would look as follows (character 
positions in decimal): 


000 001 002 003 
032 033 034 035 
- 064 065 066 067 
096 097 098 099 


Subblock 1 consists of characters 0, 1, 32 and 33. 
Subblock 2 consists of characters 2, 3, 34 and 35. 
Subblock 3 consists of characters 64, 65, 96 and 97. 
Subblock 4 consists of characters 66, 67, 98 and 99. 


Since there are four color sets two bits are required to select a color set for a 
subblock. Four subblocks require a byte and therefore each block is assigned a byte 
from color memory. The byte pairs are arranged as follows: 


Subblock 1 bits 1 
Subblock 2 bits 3 
Subblock 3 bits 5 
Subblock 4 bits 7 


It follows that each subblock is restricted to three colors plus background. The 
respective color memory bit pair selects one of four color sets and the pixel bit pair 
selects the color from the chosen color set. : 


A color memory value of $D1 (%11010001) assigns color set 2 to subblock 1, color 
set 1 to subblock 2, color set 2 to subblock 3 and color set 4 to subblock 4. 


These color restrictions are quite severe, especially in ght of the incompatibility 
with existing paint programs. The four color per subblock restriction disallows 
straight conversions from existing multi color pictures (such as in Deluxe Paint II 
EGA/VGA format). Pictures should either be drawn specifically for the NES using 
special tools, or you may use low color resolution pictures (4 color CGA) and add 
colors as you go along. 
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BACKGROUND GRAPHICS EXAMPLE CODE 
Following is a woes code segment that creates a screen out of data segments and 
displays it on the NES. 
ORG $C000 
+ NES Equates 
PCR1 EQU $2000 + PPU Control Register 1 
PCR2 EQU $2001 ? PPU Control Register 2 
PSTR EQU... $2002.. ; PPU status register 
PPCR EQU $2003 ; PPU DMA page count 
PSOR EQU .$2005 + PPU Scrolling Offset Register 
PMAR EQU $2006 * PPU Memory Address Register 
PMDR EQU $2007 * PPU Memory Data Register 
V1R1 EQU $4000 + Voice 1 Register 1 
V1R2 EQU $4001 ? Voice 1 Register 2 
V1R3 EQU $4002 : Voice 1 Register 3 
V1R4 EQU $4003 7 Voice 1 Register 4 
V2R1 EQU $4004 ; Voice 2 Register 1 
V2R2 EQU $4005 + Voice 2 Register 2 
V2R3 EQU $4006 ? Voice 2 Register 3 
V2R4 EQU $4007 + Voice 2 Register 4 
V3R1 EQU $4008 7 Voice 3 Register 1 
V3R2 EQU $4009 + Voice 3 Register 2 
V3R3 EQU $400A ; Voice 3 Register 3 
V3R4 EQU $400B ; Voice 3 Register 4 
V4R1 EQU $400C ; Voice 4 Register 1 
V4R2 EQU $400D ; Voice 4 Register 2 
V4R3 EQU $400E 7 Voice 4 Register 3 
V4R4 EQU $400F ; Voice 4 Register 4 
V5R1 EQU $4010 ; Voice 5 Register 1 
V5R1 EQU $4011 ; Voice 5 Register 2 
V5R1 EQU $4012 ; Voice 5 Register 3 
V5R1 EQU $4013 7 Voice 5 Register 4 
DPNR EQU $4014 ; DMA Page Number Register 
VMER EQU $4015 ; Voice Master Enable Register 
ShHPCR1 EQU $14 ? PCR1 shadow register 
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ShPCR2 
VScroll 
HScroll 


PCR1Init 


$1FFF 


PCR2Init 


CodeState 
Temp 
Indo 


RESVector 


Waito 
Waitl 


Wait2 
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EQU 
EQU 
EQU 


EQU 


EQU 


$15 
$16 
$17 


$10 


$06 


me we Ne 


=e %e te WO 


~e te Se Me Ne 


PCR2 shadow register 
vertical scroll offset 
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horizontal scroll offset 


clear scrolling MSB's 


set auto increment to 1 . 
sprite chars at $0000 - SOFFF 
background chars at $1000 - 


interrupt disabled 


enable color 
blank sprites 


blank background 
Gisable left border 


7 program variables 


$OA 
$F6 
$F8 


CodeState 
HScroll 
vscroll 
VMER 


#PCR1Init 
ShHPCR1 
PCR1 
#PCR2Init 
ShHPCR2 
PCR2 
ShPCR1 
#$80 
ShHPCR1 
PCR1 


~e te Se 


software state 
temporary 
pointer 


=e 


=e Se 


=e 
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init control registers 


wait for hardware 
to stabilize 


clear software state 


clear H scroll 
Clear V Scroll 
quiet all sound 


init stack pointer 


init PCR1 


init PCR2 


enable NMI interrupts 


( 
_ . 


ForeGround 


IRQVector 


NMIVector 
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ForeGround 


PSTR 
ShPCR1 
#$7F 
PCR1 
ShPCR1 


#$00 
$2003 
#$02 
DPNR 


ShPCR2 
#SE7 
ShPCR2 
PCR2 


DoGTest 


ShPCR2 
#$18 
ShPCR2 
PCR2 


HScroll 
PSOR 
vVScroll 
PSOR 


ShPCR1 
#$80 
PCR1 
ShPCR1 


=e we 


=e 


=e =e ™~e Me te Me NO 


=e te Ne 


=e =e Ne 


me Se Me Ne 


do nothing 
in the foreground 


should never happen 


save processor registers 


clear interrupt bit 
get PCR1 shadow 
disable interrupts 
save in register 
save in shadow 


DMA page count - 1 
DMA page number 


get PCR 2 shadow 
blank screen and 
and enable CPU access 


get PCR 2 shadow 
enable screen and 
block CPU access 


refresh scroll registers 


get PCR1 shadow 
enable interrupts 
save to PPU 

save to shadow 


EE end IE Se OEP Oa Te Se ORS eS ES EE Cees Sd SA ee OM aie ae gage © ekney Orta 


DoGtest 


definitions 


Gtestl 


GTest2 


LoadScreen 


Lscro 
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PLA ; restore registers 


+ actual test code 
; broken into two parts 
; for timing considerations 


LDA CodeState 
CMP #0 

BNE GTestl 
JSR ClrChars 
JSR ClrSprites 
JSR ClrScreen 


clear screen 
Clear sprite definitions 
clear character 


me we we 


INC CodeState go to next state 


=e 


CMP #1 
BNE Gtest2 
JSR LoadScreen 
INC CodeState 


load actual screen and 
colors etc. 


=e @e 


+ This routine will transfer blocks 
; from the database to their 

; respective destinations. 

+ Blocks include screen, color 

7 and character definitions 


LDA #<ScreenData ; get starting address 
STA Indo ; of data 

LDA #>ScreenData 

STA Indo0+1 


LDA PSTR ; clear any interrupts 
LDY #$00 

LDA (Indo) ,Y ; Gest address low 
STA Temp 

INY 

LDA (Indo) ,Y ; dest address high 
STA Temp+1 

AND Temp ; done if address 

CMP #SFF *; = $FFFF 


Lscrl 


Lscr2 


Lscr4 
LscrxXx 


ClrScreen 


ClrScreeno 
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=e Ne 


LDA 
STA 
LDA 
STA 
LDX 
LDY 
LDA 
STA 
DEX 
BNE 
INY 
CPY 


Lscrx 


Temp+1 ; 
PMAR 

Temp ; 
PMAR 
#$00 


(Indo) ,Y 
Temp 


#$00 
(Indo) ,Y 
Temp+1 


=e te 


(Indo) ,Y¥ ; 
PMDR 


Lscr2 
Indo+1 
Temp 
LSer1 
Temp+1 
LScerl 


~e se we 


me te 


Indo 
Indo 
Lscr4 
Indo+1 
Lscro 


clear the screen 
fill with character 


#$20 
PMAR 
#0 

PMAR 
#500 
#500 
#SFF 
PMDR 


-e 


=e 


e 
¢ 
e 
s 
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ClrScreeno 


#904 


get MSB of dest 
get LSB of dest 


get negative of 
16 bit data count 


transfer actual data 


bump source 
check counter 
for more data 


update pointer 
to next data block 


SFF 
dest MSB = $20 


dest LSB = $00 


store character 
$400 times 


OE Bal eee Oa it ee ii ite he pa oe Seeger eee ON ON ae 
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BNE ClrScreeno 
RTS 


; Clear the background 
; character set area 


CirChars LDA #$10 
STA PMAR 
LDA #$00 
STA PMAR 
LDA #0 
TAX 2 
TAY 

Clrch STA PMDR 
INX 
BNE Clrch 
LDA PSTR 
INY 
CPY #$10 
BNE Clrch 
RTS 

: ; clear the sprite 

; character area C 

ClrSprites LDA #$00 
STA PMAR 
LDA #$00 
STA PMAR 
LDA #0 
TAX 
TAY 

ClrSp STA PMDR 
INX 
BNE ClrSp 
INY 
CPY #$10 
BNE CirSp 
RTS 


ScreenData 


; the first block contains the screen data 


DW $2000 
DW $0400 
DB 0,1,2,3 


~e te 


color sets 


destination address 
data count 

total of 1024 screen 
bytes and color memory 


=e Se te Ne 


the second block contains the background 
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DW $3F00 ; destination address 
DW 16 ; data count 
DB 1,2,3,4 ; total of 16 color 

; definition bytes 


the third block contains the character 
+ set definition 
DW $1000 

DW $1000 

DB 12;,3;,4 


destination address 
data count 

total of 4096 character 
definition bytes. 


me *e@ “oe te 


3; terminator 
DW SFFFF 


3; 6502 hardware vectors 
ORG SFFFA 
DW NMIVector NMI service routine 


DW RESVector ; Reset entry routine 
DW IRQVector ; IRQ service routine 
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SPRITE PROGRAMMING 


The NES has 64 iors sprites. Each sprite consists of a 8 x 8 pixel character. 
Characters are defined the same way as screen characters are defined. The sprite 
character set may be mapped to either $0000 - $OF FF (PCR{, bit 3 = 0) or $1000 - 
$1FFF (PCR1, bit 3 = 1). 


Each sprite is defined by 4 bytes as follows: 


Byte 0: Sprite Y Position. 

Byte 1: Sprite Character number 

Byte 2: Sprite color, priority and orientation. Bits 
O and 1 are used to select a color set. Bit 
5, when set, gives background characters 
priority over sprites. Bit 7, when set, flips 
the sprite horizontally. Bit 6, when set, 
flips the sprite vertically. Bits 7 and 6 may 
be used together for diagonal mirroring. 

Byte3: Sprite X Position. 


epee data is generated by the CPU and placed in a special memory area ($200 - 
$2FF). During vblank a DMA command is used to transfer the entire sprite data 
page to the PPU. It therefore follows that sprite modifications during the active 
display cycle are not possible on the NES. 


The NES limits sprite usage to eight sprites per horizontal line. Any more sprites 
per line get ignored by the PPU and do not show up on the screen. This limitation 
may only be overcome by using “eine multiplexing. It is a commonly used technique 
in NES games, easily recognized by the annoying sprite flicker it produces. 
However, it is the only way to show more than eight sprites per line. Many scrolling 
games use sprites to provide a stationary score/status display. Because this may use 
up to eight sprites, sprite multiplexing becomes inevitable. If sprite multiplexing is 
not desired the game should be carefully designed with the sprite limitations 
observed from the very beginning. 


Since a total of 64 sprites are supported, and each sprite is specified by four bytes a 
total of 256 bytes or 1 page of memory are required. This one page is sent to the 
PPU during each VBlank service routine. 


The DMA transfers have been observed empirically. They are activated in the 
VBlank code as one of the first actions taken. This code uses the PPU DMA Page 
Count Register (PDPC, $2003) and the DMA Page Number Register (DPNR, 
$4014). The code looks as follows: 
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PDPC EQU $2003 ; PPU DMA Page Count 
DPNR EQU $4041 ; DMA Page Number 
LDA #0 ; page count 
STA PDPC 
LDA #2 ; page number 
STA DMAR 


Following is a subroutine that formats sprite data into the required 4 bytes and 
places it into the appropriate memory for DMA transfer to the PPU. Routines like 
this should be located in VBlank after the current DMA has taken place. If sprite 
data formatting is done asynchronously with VBlank data may be transferred to the 
PPU at any point in time, resulting in bad or incomplete sprites displayed. 


SpLoc EQU $200 ; sprite data base 
SpriteYLoc EQU SpLoc ; Y offset in pixels 
SpriteChar EQU SpLoct+l ; character number 
Spritectl EQU SpLoc+2 ; sprite attributes 
SpriteXLoc EQU SpLoc+3 ; X offset in pixels 
YLoc DB 80 ; Y = 80 
XLoc DB 100 ; X = 100 
SpChar DB $34 ? character $34 
SpCol DB $01 ; color set 1 
SpHFlip DB $01 ; horizontal flip on 
SpVFlip DB $00 ; vertical flip off 
SpPrior DB $00 ; front of background 
SpNum DB $05 ; physical sprite # 
SetSprite LDA SpNum ; get physical sprite # 
ASL A ; multiply by four 
ASL A ; for proper offset 
TAX ; into index 
LDA YLoc ; transfer Y location 
STA SpriteYLoc,X 
LDA XLoc ; transfer X location 


STA SpriteXLoc,X 
LDA SprcChar ; transfer character 
STA SpriteChar,X 


LDA SpCol 

STA Temp ; save color 

LDA SpPrior ; check for prior bit 

LSR A 

Bcc SS1l ; no priority bit 

LDA Temp 

ORA #$20 ; set priority bit 
hy oe 
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STA Temp 
SS1 LDA SpHFlip ; check for H flip 
LSR A 
Bcc ss2 ; no H flip 
LDA Temp 
ORA #540 ; set H flip bit 
STA Temp : 
$S2 LDA SpVFlip ; check for V flip 
LSR a 
BCC SSs3 ; no V flip 
LDA Temp 
ORA #$80 ; set V flip bit 
STA Temp 
SS3 LDA Temp ; get attributes 
STA Spritectl,x 
RTS 


Sprites are prioritized amongst themselves by their position index. The lower their 
index, the higher their priority. This applies to the eight sprite limit. If you try to 
display sprites 1 through 10 on the same line sprites 9 and 10 will be blanked by the 
hardware. There is no hardware detection mechanism accessible by the program for 
detecting the eight sprite limitation. 


The most common way of disabling sprites is setting the Y coordinate to a value of 
$F8. This seems to move the sprite off the bottom of the screen and effectively 
disables that sprite. 


Sprite to background priority can be controlled through bit 4 of SPRITECTL. If bit 
4 = 0, sprites appear above the background, otherwise the sprites will be behind 
background graphics. 


Since each sprite has its own color set selection the color limitations existing for 
background characters do not apply to sprites. 


-24- 


PON SRE EN ERE Be ee eae, NPR CSG AS ay | iy eo ARSE SAO OEE 


NES PROGRAMMER'S REFERENCE GUIDE 


SPRITE COLORS 


Sprite colors are arranged similarly to character colors. Following is a map of the 
color locations in PPU memory: 


$3F11 color set #1 color for bit combo 01 
$3F12 color set #1 color for bit combo 10 
$3F13 color set #1 color for bit combo 11 
$3F14 color set #2 background (not used) 
$3F15 color set #2 color for bit combo 01 
$3F16 color set #2 color for bit combo 10 
$3F17 color set #2 color for bit combo 11 
$3F18 color set #3 background (not used) 
$3F19 color set #3 color for bit combo 01 
$3F1Acolor set #3 color for bit combo 10 
$3F1B color set #3 color for bit combo 11 
$3F1C color set #4 background (not used) 
$3F1Dcolor set #4 color for bit combo 01 
$3F1E color set #4 color for bit combo 10 
$3F1F color set #4 color for bit combo 11 
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SPRITE EXAMPLE CODE 


Following is a working code segment that displays and animates sprites from data 


statements. 


FrameData 


AnimData 


ORG 


OJ we ~e ~e we 


108 bytes. 
B 1,2,3,4 
ORG SBFOO 
+ contains the 
DB 1,2,3,4 
ORG $coo00 


; NES Equates 


$8000 


$2000 
$2001 
$2002 
$2003 
$2005 
$2006 
$2007 


$4000 
$4001 
$4002 
$4003 


$4004 
$4005 
$4006 
$4007 


$4008 
$4009 
$400A 
$400B 


$400C 
$400D 
$400E 


+ $3600 frame bytes 


current animation data 


me Se Se Ne =e Ne Se Ne me te Me te Me NO Ne 


=e ™e Me Me 


™e se te 


PPU Control Register 1 
PPU Control Register 2 
PPU status register 


contains the frame data describing 
what components a sprite is made of 
there are 128 definitions each using 


PPU DMA page count 
PPU Scrolling Offset Register 
PPU Memory Address Register 
PPU Memory Data Register 


Voice 
Voice 
Voice 
Voice 


Voice 
Voice 
Voice 
Voice 


Voice 
Voice 
Voice 
Voice 


Voice 


Voice 
Voice 


SoG 


i 
Af 
1 
x 


WWW WwW NNN ND 


> bP 


Register 
Register 
Register 
Register 


Register 
Register 
Register 
Register 


Register 
Register 
Register 
Register 


Register 
Register 
Register 


PUWUNP PUNE RWNPB 


WNH 


eh eee ee a ge SE ee Sas ee eS Me ee 


ShPCR1 
ShPCR2 
vscroll 
HScroll 


PCR1Init 


$1FFF 
PCR2Init 


CodeState 
Temp 
Indo 


RESVector 


Waito 


Waitl 


Wait2 
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EQU 


$06 


me Se Se tO =e 


=e Se Se Ne ~e me 


~-e =e Te TO 


=e Se NO Se te 


Voice 4 Register 4 


Voice 5 Register 
Voice 5 Register 
Voice 5 Register 
Voice 5 Register 


WNP 


DMA Page Number Register 
Voice Master Enable Register 


PCR1 shadow register 
PCR2 shadow register 
vertical scroll offset 
horizontal scroll offset 


clear scrolling MSB's 

set auto increment to 1 
sprite chars at $0000 - S$OFFF 
background chars at $1000 - 


interrupt disabled 
enable color 

blank sprites 

blank background 
disable left border 


; program variables 


CodeState 
HScroll 


° 
’ 
. 
’ 
. 
e 


software state 
temporary 
pointer 


; init control registers 


; wait for hardware 
; to stabilize 


; clear software state 
; clear H scroll 


O72 
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STX VScroll ; Clear V Scroll 

STX  VMER ; quiet all sound 
DEX . 

TXS ; init stack pointer 
LDA #PCR1Init ; init PCR1 

STA ShPCR1 

STA PCR1 

LDA #PCR2Init ; init PCR2 

STA ShPCR2 

STA PCR2 

LDA ShPCR1 ; enable NMI interrupts 
ORA #$80 

STA ShPCR1 

STA PCR1 


ForeGround NOP ; do nothing 
NOP ; in the foreground 
NOP 


JMP ForeGround 


should never happen 


IRQVector CLI ; 
RTI 
NMIVector PHP ; Save processor registers ( 
PHA : ~ 
TXA 
PHA 
TYA 
PHA 
LDA PSTR ; clear interrupt bit 
LDA ShPCR1 7 get PCR1 shadow 
AND #$7F ; disable interrupts 
STA PCR1 ; save in register 


STA ShPCR1 save in shadow 


LDA #$00 ; DMA page count - 1 
STA $2003 

LDA #$02 ; DMA page number 
STA DPNR 


LDA ShPCR2 get PCR 2 shadow 


AND #SE7 + blank screen and 
STA ShPCR2 7 enable CPU access 
STA PCR2 


JSR DoSTest 


DoStest 


Stestl 


Stest2 


STest3 
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ShPCR2 
#$18 
ShPCR2 
PCR2 


HScroll 
PSOR 
vScroll 
PSOR 


ShPCR1 
#580 
PCR1 
ShPCR1 


me Se Ne 


=e 


me ™e Ne te 


=e 


get PCR 2 shadow 
enable screen and 
block CPU access 


refresh scroll registers 


get PCR1 shadow 
enable interrupts 
save to PPU 

save to shadow 


restore registers 


? actual sprite display code 


CodeState 
#0 

SsTest1 
ClrChars 
ClrSprites 
ClrScreen 
CodeState 


#$01 

Stest2 
LoadSprites 
CodeState 


#2 

Stest3 
InitSprites 
CodeState 


#3 
Stest4 
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STest4 


SprPptr 
sprite def 
SprColiIdx 
SprDatIdx 
SprChridx 
SprRow 
SprColumn 
SprRowOfs 
Sprcolofs 


StepPtr 
step 
CurrX 
Curry 
StepIndex 
StepFrame 
StepDelay 
StepRep1l 
StepRep2 


InitSprites 


DoSprites 


SPs ee Tye RYERSS 
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JSR DoSprites 
RTS 


; Sprite working 


EQU $20 ; 
EQU $22 ; 
EQU $23 ; 
EQU $24 ; 
EQU $25 ; 
EQU $26 ; 
EQU $27 ; 
EQU $28 ; 
EQU $100 ; 
EQU $101 ; 
EQU $102 ; 
EQU $103 ; 
EQU $104 ; 
EQU $105 ; 
EQU $106 ; 
EQU $107 ; 


; initialize the 


LDA #0 
STA StepPtr 
LDA #100 


LDY #$06 
JSR SetBank 
LDA #0 


STA StepIndex 
STA StepDelay 
STA SprChridx 
STA StepRep1l 
STA StepRep2 
RTS 


variables 
two byte ptr to beginning of 


current sprite color offset 
current sprite data offset 
physical sprite character 
sprite row 

sprite column 

row offset in pixels 

column offset in pixels 


; points to current animation 


current X coordinate 
current Y coordinate 
index of current step 
current frame used 
delay for this frame 


repeat count 1 


repeat count 2 


sprite parameters 


; Clear step ptr 


7; X = 100 
; Y = 100 
; switch bank 6 into 
; area $8000 - SBFFF 


step index 

step delay 
character index 
repeat count 1 
repeat count 2 


~e Se Me te Ne 


; animate the sprites 


LDA StepDelay 
CMP #0 

BEQ DoSpo 

DEC StepDelay 


; check for timeout 
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DoSpo 


DoSpl 


DoSp2 


DoSp3 
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StepIndex 
AnimData, X 
#0 

DoSp1 
DoSp200 

#1 

DoSp2 


AnimDatatl, 


StepFrame 


AnimData+2, 


Currx 


AnimData+3, 


Curry 


#6 
StepIndex 
StepFrame 
DrawSprite 


DoSp3 


AnimDatat2, 


CurrXx 


AnimData+3, 


Curry 


#6 
StepIndex 


DoSp4 


Animdata+tl, 


StepFrame 


AnimData+t2, 


CurrxX 
Currx 


AnimData+3, 


Curry 
Curry 


AnimData+ts, 


StepDelay 


check type 
of animation 


=e Se 


; type 1 

X ; get frame 

X 3; get current X 

X ; get current Y 
; point to next data 
; draw current sprite 
; type 2 

xX 

X 
; type 3 

X 

».4 


xX 


xX 


ee 


DoSp4 


Dosp41 
DoSp42 


DoSp43 


Dosp44 


Dosp45 


DoSp5 


DoSp51 
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#6 
StepIndex 
#0 
SprChrIdx 
StepFrame 
DrawSprite 


#4 

DoSp5 
StepRep1 
#0 
DoSp41 


AnimDatat5, 


StepRep1 
DoSp42 
StepRep1 
StepRep1l 
#0 
DoSp45 


AnimDatat+4, 


DoSp43 
StepIndex 
DoSpo 


#6 
StepIndex 
DoSpo 

#5 
DoSp200 
StepRep2 
#0 

DoSp51 


AnimData+t5, 


StepRep2 
DoSp52 
StepRep2 


Xx 


xX 


xX 


35°. 


type 4 


Dosp52 


DoSp53 


DoSp54 


DoSp55 


DoSp200 
DoSp202 


DrawSprite 


Dspo 


Dspl 


Dsp2 
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LDA StepRep2 

CMP #0 

BEQ DoSp55 ; 
LDA AnimData+4 ,X 


JMP Dosp53 
STX StepIndex 
JMP DoSpo 


TXA 
CLC 
ADC #6 
STA StepIndex 
JMP ~ DoSpo 
LDA #4 
STA CodeState 
RTS 
LDA #<FrameData 
STA SprPtr ; LSB of frame data 
LDA #>FrameData 
STA SprPtr+1 ; MSB of frame data 
DEX 
CPX #0 
BEQ Dsp2 
LDA #$6C ; size of sprite definition 
CLC + block 
ADC SprPtr 
STA SprPtr 
BCC Dspl 
INC SprPtr+1 
DEX 
JMP Dspo 
LDY #$48 
STY SprCcolIdx 
LDY #$00 
STY SprDatIdx 
STY SprRow 
STY SprColumn 
-33- 
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STY SprRowOfs 
STY Sprcoldfs 
LDX SprChrIdx 


Dsp10 LDY SprDatIdx 
INY 
LDA (SprPtr) ,Y 
DEY 
CMP #$00 
BEQ Dsp12 
INY 
INY 


STY SprDatIdx 
JMP Dsp15 
Dspl2 LDA Curry 


ADC SprRowOfs 
STA SpYLoc, xX 
LDA ._ (SprPtr) ,Y 
STA SpChar, X 


STY SprDatIdx 
LDY SprcoliIdx 
LDA (SprPtr) ,Y 
STA Spctl1,X 
LDA CurrX 


ADC Sprcolo0fs 
STA SpXloc,X 
Dsp14 INX 


STX SprChridx 
Dsp15 INC SprColIdx 
LDA Sprcolo0fs 


ADC #8 
STA Sprcolo0fs 
INC SprColumn 


CMP #6 

BEQ Dsp16 

JMP Dsp10 
Dsp16 — LDA #0 


STA SprcColumn 
STA SprcolO0fs 
LDA SprRowOfs 


234: 


Dsp17 


SetBank 


Banks 


LoadSprites 


Lscro 
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ADC #8 

STA SprRowOfs 
Inc SprRow 
LDA SprRow 


CMP #6 
BCS Dsp17 
JMP Dsp10 
RTS 


+ bank switching routine 


LDA Banks,Y 

STA Banks ,Y 

RTS 

DB 0,1,2,3,4,5,6,7 


me Se te Me NO 


LDA #<SpriteData ; 
STA Indo ; 
LDA #>SpriteData 
STA Indo+1 


LDA PSTR ; 
LDY #$00 

LDA (Indo) ,Y ; 
STA Temp 

INY 


LDA (Indo) ,Y¥ ; 
STA Tempt+1 


2 
A) 
a 
n 
yy 
ny 


INY 

LDA Temp+1 ; 
STA PMAR 

LDA Temp ; 
STA PMAR 

LDA #$00 ; 
SEC ; 
SBC (Indo) ,Y 

STA Temp 

INY 
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This routine will transfer blocks 
from the database to their 
respective destinations. 

Blocks include sprite colors 

and sprite character definitions 


get starting address 
of data 


clear pending interrupts 


dest address low 


dest address high 


; done if address 


= SFFFF 


get MSB of dest 


; get LSB of dest 


get negative of 
16 bit data count 


Lscrl 


Lscr2 


Lscr4 
Lscrx 


ClrScreen 


ClrScreeno 


ClrChars 
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we te 


#$00 
(Indo) ,Y 
Temp+1 


(Indo) ,Y 
PMDR 


Lscr2 
Ind0+1 
Temp 
LScrl 
Temp+1 
LScr1 


Indo 
Indo 
Lscr4 
Indo+1 
Lscro 


#$20 
PMAR 
#0 

PMAR 
#$00 
#$00 
#SFF 
PMDR 


ClrScreeno 


#$04 
ClrScreeno 


; transfer actual data 


bump source 
check counter 
for more data 


=e te te 


; update pointer 
; to next data block 


clear the screen 
fill with character $FF 


dest MSB = $20 


=e 


; dest LSB 


Ml 
wn 
° 
° 


; store character 
$400 times 


=e 


? Clear the background 
; character set area 


LDA 
STA 
LDA 
STA 
LDA 


#$10 
PMAR 
#$00 
PMAR 
#0 


2365 
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TAX 
TAY 
circh STA PMDR 

INX 
BNE Clrch 
LDA PSTR 
INY 
CPY #$10 
BNE Clrch 
RTS 


- 7 Clear the sprite 
3; character area 


ClrSprites LDA #$00 


STA PMAR 
LDA #$00 
STA PMAR 
LDA #0 
TAX 
TAY 
ClrSp STA PMDR 
INX F 
BNE ClrSp 
INY 
CPY #$10 
BNE ClirSp 
RTS 
SpriteData ; the first block contains the sprite 


+ color sets 

DW $3F10 ; destination address 
DW 16 + data count 

; total of 16 color 

; definition bytes 


; the second block contains the sprite 

; character set definition 

DW $0000 ; destination address 

DW $1000 ; data count 

DB 1,2,3,4 ; total of 4096 character 
; definition bytes. 


; terminator 
DW SFFFF 


7; 6502 hardware vectors 


Bey he 


SS eee ERR 
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ORG SFFFA 


DW NMIVector : NMI service routine 
DW RESVector ; Reset entry routine 
DW TRQVector ; IRQ service routine 


END 


SCREEN BLANKING 


The PPU Control Register 2 (PCR2, $2001) controls several functions. Bit 0, when 
set, turns the display to monochrome Bit3, when set blanks the background. Bit 4, 
when set, blanks the sprites, For the CPU to alter background or sprites, the 
respective blanking bit must be set .[tseems that writes to PCR1 have no effect 
when either of the blanking bits are set. 


The purpose of the blanking bits is thus twofold. They may be used to blank a screen 
when building a screen to prevent screen jumping and distortion, since the screen 
becomes unstable when accessed during the visible portion of the frame. They must 
also be set to allow CPU access to the video memory and registers. 


PCR2 EQU $2001 

ShPCR2 EQU SFE 

NMIEntry LDA ShPCR2 ; get shadow ( 
ORA #$18 ; blank bg/sprites ml 
STA ShPCR2 ; Save shadow 
STA PCR1 ; store register 


do all video reads/writes until 
visible portion of screen is reached. 
You can transfer about 100 characters 
to the screen during this time 


~e te Me NO 


NMICont LDA ShPCR2 ; get shadow 
AND #S$E7 ; enable bg/sprites 
STA ShPCR2 ; save shadow 
STA PCR1 ; store register 


the screen becomes active and will 
not be disturbed. Game logic should 
be handled here. 


me te Ne 


NMI CONTROL 


The CPU has not internal NMI generation. NMIs are generated by the PPU at a 
60Hz rate. Most NES games use the NMI signal to synchronize the entire program 
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execution to. NMI on cannot be disabled at the CPU, but NMI generation 
can disabled at the PPU. 


Register PCR1, bit 7 is the interrupt enable bit. NMI's are generated when bit 7 = 1. 
This bit should be reset upon entry into VBlank and set again upon exit. This code is 
commonly found in NES games: 


PCR1 EQU $2000 
ShPCR1 EQU SFF 
NMIEntry LDA ShPCR1 ; get shadow 
AND #$7F ; reset intr enable 
STA ShPCR1 ; save shadow 
STA PCR1 ; store register 
NMIExit LDA ShPCR1 ; get shadow 
ORA #$80 ; set intr enable 
STA ShPCR1 ; save shadow 
STA. PCR1 ; store register 


The PPU Status Register (PSTR, $2002) is a read only register. This register 
contains the NMI occurred flag. It must be read after every interrupt to re-enable 
interrupts. Reading this register not only clears the interrupt occurred bit but also 
seems to reset the scroll registers. Since you have to read this register everytime you 
execute VBlank you must also reset your scrolling registers every time you go 
through VBlank. The register is accessed by simply reading it. 


All NES ab use the interrupt bit in the initialization code to let the hardware: 
stabilize. The code waits for 2 or 3 interrupts to occur before any action is taken. 
The interrupt bit is simply polled. The wait loops look as follows: 


PSTR EQU $2002 
Waitl LDA PSTR 
BPL Waitl ; Loop while bit 7 reset 
Wait2 LDA PSTR 
BPL Wait2 
Wait3 LDA PSTR 
BPL Wait3 
IRO CONTROL 


The CPU does generate internal IRQs. These are logically wire-ored to the external 
IRQ pin. The PPU does not generate IRQs. MMC3 cartridges may be programmed 
to generate an IRQ. In all other environments the external IRQ pin on the CPU is 
left unconnected. 
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An internal IRQ is generated at the end of any CPU DMA cycle. DMA cycles 
include sprite parameter — CPU to PPU and cas ba sound output. IRQ 

eneration can be disabled. IRQ recognition is controlled through the 6502 
instructions CLI and SEI. 


The source of an internal IRQ can be identified as follows: 
VMER $4015 (Read) 
Bit 7 = 1 sample sound done 
Bit 6 = 1 sprite transfer done 


IRQ generation can be enabled as follows: 


JOY2PORT $4017 (Write) 
Bit 7 = 1 (always) 
Bit 6 = O IRQ enable 
GAME CONTROLLERS 


The NES has two game controller ports. The most commonly used game controllers 
are the joystick controllers supplied with each console. The controllers contain up to 
eight switches. 


When controllers are to be read first a load command is issued by the CPU 
(JOY1PORT, $4016 and JOY2PORT, $4017). The load command then transfers 
the individual switch states into an 8 bit shift register in the controller. This is 
followed by 8 successive reads of the controller port to get all 8 status bits into the 
processor. Since the controllers are simple digital switches the resulting data 
represents simple on/off information for each switch. 


Following is a code example of a joystick read routine. The routine, which should be 


called once every frame, reads the 8 data bits and assembles a command word. It 
further generates a debounced output and has a facility for autorepeat. 


; this routine will read controller A 


JOYBUTA EQU %10000000 7 ‘At Button 
JOYBUTB EQU %01000000 ; 'B’' Button 

JOYSEL EQU %00100000 ; Select 

JOYSTART EQU %00010000 ; Start 

JOYUP EQU %00001000 ; Up 

JOYDOWN EQU %00000100 ; Down 

JOYLEFT EQU %00000010 ; Left 

JOYRIGHT EQU 400000001 ; Right 

JoylPort EQU $4016 ; Controller A port 


SS SS Se eee SOS etek ee pei er es 


Joy2Port 
JoylLast 
Joy1Data 


Joy1lEdge 
Joyl1Delay 


ReadJoy 


ReadJ1 


ReadJ2 
ReadJ3 
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EQU 


EQU 
EQU 
EQU 
EQU 


$4017 


$00 
$01 
$02 
$03 


=e te Me Be 


Controller B port 


Ctrl A last value 
Ctrl A current data 
Ctrl A debounced data 
Ctrl A repeat delay 


; Controller read routine with auto repeat 
+ Should be called from within vblank 


#1 
JOYIPORT 


JOY1PORT 
#8 


JOY1PORT 
JoylLast 
A. 
JoylLast 
A 


A 


ReadJ1 
Joy1Data 
JoylLast 
Joyl1Data 
JoylLast 
Joyl1Data 
JoylEdge 
#$30 
Joy1Data 
JoyiLast 
ReadJ2 


Joyl1Delay 


ReadJ3 
JoylEdge 
#10 


Joyl1Delay 


we Me Me Te NO NO ~e =e Se 


=e 


~e te 


load controller 1 shift 
shift register 


number of bits 
save current new bits 
get next bit(s) 


shift down second bit 
fold in first bit 

new bit into carry 
restore new bits 
shift in new bit 

dec bit counter 


transfer previous data 
save new data 

debounce it 

delay until repeat 

see if new data 

start new delay 


store repeat value 
delay between repeats 


I have also seen other types of controllers. The game 'Arkanoid' requires a paddle 
controller and is packaged with a dedicated controller (It can be played with a 


SATS 
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paddle, but this is somewhat awkward). This controller performs A/D conversion of 
the current paddle potentiometer position and generates digital position data. 


The light gun consists of a light sensitive photocell which kicks in when a certain 
threshold of light intensity is exceeded. 


Other controllers with auto fire repeat contain timing circuits that periodically send 
new button presses whenever a certain button is kept depressed. 


The controller ports can be viewed as general purpose eight bit input only ports. 
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SOUND PROGRAMMING 


Sound generating hardware is located in the CPU. There are several different 
voices, each individually programmable. Each voice functions differently. 


VOICE 1 


Voice 1 generates a square wave output. Amplitude, frequency and duty cycle are 
programmable. 


VOICE 1 FREQUENCY 


The frequency is set by writing an 11 bit value to VIR3 ($4002, BITS 0 - 7, LSB) and 
V1R¢4 ($4003, bits 0 - 2, MSB). A seven octave frequency table follows: 


Octave 1 2 3 4 5 6 7 

Cc $6AD $356 S$1AA S$0D4 S$O6A $035 SO1A 
Cc# $64A $325 $192 $0c9 $064 $031 $019 
D $5EF $2F8 $17B SOBD S$O5E $02E $018 
D# $59B $2CD $166 $0B3 $059 $02C $016 
E $54B $2A5 $152 S$o0A9 $054 $029 $015 
F $4FE $27F $13F S09F $04F $027 $014 
F# $4B5 $25B $12D $096 $O4A $025 $013 
G $473 $23A $11C S$O8E $047 $023 $012 
G# $430 $219 $10Cc $086 $042 $021 $011 
A $3F5 $1FB S$OFD $07E $O3E $01F $010 
A# $3BD $1DE S$OEF $077 $03B $01D SOOF 
B $387 $1C3 $0E1l $070 $038 $01B SO0OE 

VOICE 1 DUTY CYCLE 


The duty cycle of the square wave output is selectable from four preset values. The 
duty cycle will alter the timbre of the sound. The closer you get to a 50% duty cycle, 
the fuller the sound will be. A 50% duty cycle will sound like a sine wave, whereas a 
lower duty cycle will produce the raspy sound of a sawtooth. The duty cycle is 
saree as a percentage of the square wave being at a '1' level versus the entire 
period. 


The duty cycle is selected by setting V1R1 ($4000, bits 7,6). Values are as follows: 
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B7 B6 Duty Cycle(%) 


0 Oo 12.5 
Oo ol 25.0 
1 0 50.0 
1 1 75.0 


VOICE 1 SOUND LENGTH 


Sound lengths may be programmed in hardware or controlled through software. The 
length mode is specified by V1R1 bit 5. If bit 5 = 1 the sound is continuous, 
otherwise a length counter is employed. 


The length counter occupies the upper 5 bits of V1R4. It holds a 5 bit code that 
specifies an 8 bit count in jiffies (A jiffy is 1/60th of a second). When V1R1 bit 5 is 
reset the following length codes become active: 


Code (Hex) Length (Jiffies, Decimal) 
00 5 
01 126 
02 10 
03 1 
04 19 
05 2 
06 40 
07 3 
08 80 
09 04 
OA 30 
0B 5 
oc 7 
oD : 6 
OE 13 
OF 7 
10 6 
11 8 
12 12 
13 9 
14 24 
15 10 
16 48 
17 11 
18 96 
19 12 
1A 36 
1B 13 
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1c 8 
1D 14 
1E 16 
iF 15 


This table does not strike me as being very useful. I have very rarely seen a program 
make use of hardware lengths. You may derive a set of standard note durations 
from the above table, but you can't implement tempo changes. It therefore seems 
advisable to create your own duration tables and let the software keep track of note 


lengths. 


VOICE 1 AMPLITUDE/ENVELOPE 


Amplitude can be epeciied by writing to V1R1, bits 0 - 3. For this to work properly 
bit 4 has to be set. The amplitude can be directly written consisting of a 4 bit value, 
where $0F is maximum amplitude. When bit 4 is reset the wave generator goes into 
some kind of hardware envelope control. The exact mode of operation has not yet 
been determined. 


VOICE 1 FREQUENCY SWEEP 


V1R2 allows a hardware frequency sweep. Bit 7, when set, activates frequency 
sweep. Bit 4 is the sweep direction, 0 decreases the pitch and 1 increases the pitch. 
Bits 2 - 0 control the pitch speed. 0 is the slowest delay (fastest sweep) and 7 is the 
longest delay (slowest wees). 


In summary the voice 1 registers function as follows: 


V1iR1 $4000 DDLMAAAA, where 
D duty cycle selection 


L = Sound length mode 
M = amplitude/envelope mode 
A = Amplitude value 

V1R2 $4001 OxxxDCCC, where 
O = frequency sweep enable 
D = sweep direction 
C = sweep delay 

V1R3 $4002 FFFFFFFF, where 


F = frequency lower 8 bits 
V1R4 $4003 LLLLLFFF, where 


F = frequency upper 3 bits 
L = length code 
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Voice 1 can be enabled by setting bit 0 of the Voice Master Enable Register 
(VMER, $4015) and disabled by resetting bit 0. 


VOICE 2 


Voice 2 functions identically to Voice 1. The entire discussion for Voice 1 is valid 
for voice 2 except for reassignment of the registers. 


The Voice 2 registers function as follows: 


V2R1 $4004 DDLMAAAA, where ar 
D = duty cycle selection —-—- 
L = Sound length mode<:~ 
M = amplitude/envelope mode 
A = Amplitude value 
V2R2 $4005 OxxxDCCC, where 
O = frequency sweep enable 
D = sweep direction 
C = sweep delay 
V2R3 $4006 FFFFFFFF, where 
F = frequency lower 8 bits Cc 
V2R4 $4007 LLLLLFFF, where 


F = frequency upper 3 bits 
L = length code 


Voice 2 can be enabled by setting bit 1 of the Voice Master Enable Register 
(VMER, $4015) and disabled by resetting bit 1. 


VOICE 3 


Voice 3 is a triangle wave sound generator. It includes the features of Voices 1/2, 
except frequency sweep. Its output is muted and has accompanying noise. 


VOICE 3 LENGTH 


Voice 3 length is specified the same way that sound length is specified for voices 
1/2, except the hardware length enable bit is bit 7, V3R1 ($4008). It also seems as if 
the lower 7 bits of V3R1 can be used to directly specify a 7 bit jiffy count, as 
opposed to using codes. This length counter becomes active when the alternate 
length counter (V3R4) is assigned a decoded value less than the value in V3R1. The 
exact purpose of this setup is unclear for me. 
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The Voice 3 registers function as follows: 
V3R1 $4008 ELLLLLLL 
z -- -—E = Sound length mode 
L = sound length setting 


V3R2 $4009 Not Used 


V3R3 $400A FFFFFFFF, where 

F = frequency lower 8 bits 
V3R4 $400B LLLLLFFF, where 

F frequency upper 3 bits 


L 2 length code 
Voice 3 can be enabled by setting bit 2 of the Voice Master Enable Register 
(VMER, $4015) and disabled by resetting bit 2. 


VOICE 4 


Voice 4 is a pseudo random noise generator. It duplicates the sound length and 
amplitude functions of Voices 1/2. 


VOICE 4 FREQUENCY 


Even though the frequency of a noise generator is random, there seems to be a way 
to change the frequency range of the noise output. V4R3, lower nibble, seems to 
change the sound characteristics of the resulting output, the exact function or 
frequency range produced by the discreet value used is unknown to me. 


The Voice 4 registers function as follows: a 


V4R1 $400C XXLMAAAA, where 
L = Sound length mode 
M = amplitude/envelope mode 
A = Amplitude value 

V4R2 $400D Not Used 

V4R3 $400E XXXXFFFF, where 


F = noise frequency range 


V4R4 $400F LLLLLxxx, where 
L = length code 


-47- 


FNS ees RET Te gto gah oo Re at eee NGeR Rgee aa eNE oe ORNS SET ce ey MN a Ree 


NES PROGRAMMER'S REFERENCE GUIDE 


Voice 4 can be enabled by setting bit 3 of the Voice Master Enable Register 
(VMER, $4015) and disabled by resetting bit 3. 


VOICE 5 


Voice 5 is a D/A channel used to playback sampled sounds. There are two methods 
available to play back digitized sound. 


The first method uses a straightforward approach in which you write a byte at a time 
to a register which immediately converts the written digital value to an analog value 
and sends it out through the sound outputs. This method requires you to periodically 
write data at the desired sample rate. 


The second method is fully automatic, but it uses delta modulation. In delta 
Ta¢duiation each new value does not replace the old one but rather is used to 
modify the old value. In this particular implementation data is clocked in at a 
predetermined sample clock rate. At each tick of the clock the next available bit 
determines how the existing D/A value is modified. If the bit is set the existing value 
is incriminated, otherwise the existing value is decremented. 


It follows that your raw digital data must be in a form in which each byte differs 

from the preceding one by one, either plus or minus. You then build an array of bits 
representing the difference (1 = +1, 0 = -1) between each successive byte. Now put 

eight bits into a byte, with the most significant bit in bit position 7. You now have an - 
array of packed deltas, eight deltas per byte. This represents the digital data as C 
required by the delta mod circuit. 


To prepare for sound output you load registers with the sample length (number of 
packed bytes), the sample start (a memory location) and the initial value of the D/A 
converter. To start sound you set bit 4 of VMAR ($4015) to 1. 


The sample will play and sound output will terminate when the end of the sample is 
reached. Automatic repeat is also available, in which case you have to stop sound 
output by resetting bit 4 in VMAR. Upon completion of a sample an internal IRQ 
will be generated, if enabled. 


A sample output is generated by checking the current bit at every sample clock tick 


and pope uaa | or decrementing the current D/A value. A new byte of delta bits 
is fetched every 8 sample clock ticks. 


VOICE 5 REGISTERS 


Voice 5 registers function as follows: 
V5R1 $4010 IRxxSSSS where 


I = IRQ enable 
R = repeat enable 


- 48 - 


V5R2 


V5R3 


V5R4 


NES PROGRAMMER'S REFERENCE GUIDE 


S = sample clock frequency 


$4011 DDDDDDDD where 
D = Direct data register. This data 
is directly output to the D/A 
converter. 


$4012 AAAAAAAA where 
A = Delta mod address pointer. 
Should be initialized to point 
at beginning of data. Note that 
this represents bits 6 through 13 
of the true address. Bits 0 through 
5 are assumed to be 0 and bits 13 
and 14 are assumed to be 1. 


$4013 ccecccccc where 
C = 8 bit count of delta mod bytes. 
Note that this represents bits 4 
through 11 of the true count. The 
lower nibble is always set to 0. 
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CARTRIDGE TYPES 


I have come across several different s of cartridges, which I will list and 
describe. This list is not exhaustive, since [ haven’t looked at all available cartridges. 


On the program side the NES decodes memory space $8000 - $FFFF in which 
almost all cartridge activities take place. eg Ca are cartridges that allow 
external program memory ($6000 - $ . The NES, however, does not generate 
any ‘sina signals to decode this space. The logic for doing so must be on the 
cartridge. 


On the character side the NES decodes and assigns memory space $0000 - $1FFF, 
which is used for character and sprite character set definition. On some cartridges 
part of the memory may be used as extra screen memory. Again the logic for 
performing these tasks must be on the cartridge. 


The cartridge also decides whether to set scrolling mode to horizontal or vertical. 
On the more basic types this is achieved through solder shorts. On other types 
cartridge logic allows software commands to select the scrolling mode. 


Some cartridges have optional battery backup for the external program memory 

only. This is used in games like Zelda to save the game environment for later 

continuation. The scheme is slightly unreliable. If the NES gets powered up without 

pressing the reset button simultaneously (as the warning states on such carts) the 

Procesior might spuriously write to external memory, destroying saved game 
ormation. 
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TYPE 1 CARTRIDGES 


These are the most basic type eae The may have up to 32K of proprans ROM 
permanently mapped to CPU $8 - SFFEF. They have 8K of character 

OM/RAM mapped to PPU $0000 - $1FFF. The scrolling mode is selected by a 
solder short on the cart. 


Type 1 carts include Duckhunt, Elevator Action, Golf, Gyromite, Kung Fu, Mario 
Bros., creer Super Mario Bros., Excite Bike, Urban Champion, Galaga, Xevious 
and Pac-Man. 


A variation of Type 1 carts allows you up to 32K (4 banks) of character ROM. 


Carts using this variation include Arkanoid, Spy Hunter, Gotcha, Mickey 
poveccpeue’s Legend Of Kage, Track And Field, Donkey Kong/Junior, Gradius 
and Starforce. 


The character bank is selected by writing a value from 0 to 3 to any address in 
program memory. To avoid bus contention, the value to be written should first be 
placed on the data bus by a read statement followed immediately by a write. 


A general purpose bank select routine to achieve this could be written as: 


e e 


LDA #1 
JSR SetCBank 


SetCBank TAY 7 transfer bank to Y 
LDA cCBanks,Y ; put value on data bus 
STA $8000 7 select bank 
RTS 

CBanks DB 0,1,2,3 
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TYPE 2 CARTRIDGES 


This type offer program memory bank selection in 16K units and a single 8K 
character ROM. The scrolling mode is selected by a solder short on the cart. 


Type 2 carts include Commando, Double Dribble, Castlevania, Ghost’s-n-Goblins, 

Rush’n Attack, Ikari Warriors, The Goonies II, Jackal, Wrestling, Blades Of Steel, 

ie coer pep ape Legendary Wings, Stinger, Gunsmoke, Contra, Super Pitfall and 
orld Runner. 


MS banks are mapped as follows. Special logic on the cart permanently maps 
bank 7 of program memory to CPU area $C000 - SFFFF. The 6502 vectors and 
initialization code only have to reside in bank 7. The remaining program area, $8000 
- SBFFF can contain any of the 8 banks, even though replicating bank 7 into the 
lower area doesn’t make much sense. 


Bank selection is subject to the same restrictions as apply for Type 1 carts. The 
previous bank selection routine has to be slightly altered as follows: 


LDA #1 
JSR SetPBank 


SetPBank TAY ; transfer bank to Y 
LDA PBanks,Y ; put value on data bus 
STA $8000 7 select bank 
RTS 

PBanks DB 0,1,2,3,4,5,6,7 


HYBRID TYPES 


Even though I haven’t come across any I would imagine there are carts that allow 
both program and character bank selection. Since the LS161 latch on the cartridge is 
4 bits wide you could assign 2 bits to character bank selection and 2 bits to program 
bank selection, or any combination requiring a total of 4 bits. 
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MULTI MEMORY CONTROLLER 1 


The Multi Memory Controller 1 (MMC1) is a PAL installed on cartridges that 
allows program and character bank selection and size setting. It also allows for H/V 
selection through software and enables a program to use cartridge character 
memory of 2 video screens for a total of 4 video screens, allowing smooth diagonal 
scrolling. Finally the MMC1 will support exterior program RAM. 


Cartridges using the MMC1 include Zelda, Zelda I, Rad Racer, Metroid, Kid 
Icarus, Double Dragon, Cobra, Castlevania I, Karnov, Fighting Golf, Ninja Gaiden, 
Blaster Master, Double Dragon and Xenophobe. 


The MMC1 allows a program address sit of 256K Bytes (PAO - PA17). Propen 
banks may be 32K/per bank, yielding 8 banks maximum, or 16K/per bank, yielding 
16 banks maximum. The MMC1 controls which bank of planar memory is active at 
any time. Because the MMC1 does not generate a fixed program control area reset 
vectors and code must be located in each 16K segment to assure proper startup. 


External program RAM is supported (8K Bytes mapped at $6000 - $7FFF). 
Provisions are made for optional battery backup to retain game parameters in 
external program RAM. 


Character memory may be either RAM or ROM. An address space of 128K Bytes is 
supported (CAO - CA16). Character banks oe 4K/per bank, nip ae banks 
maximum, or 8K/per bank, yielding 16 b maximum. When 4K banks are 
selected the two banks don’t have to be continuous. 


Screen memory selection is through software. See the MMC1 register description 
for functional details. 


The MMC1 is 3a ean by writing to specific areas in ah ta memory. Since 
the MMC1 has only two data inputs data must be sent bit by bit through software. 


Active bits are D7 (control) and DO (data), therefore during a data transfer only 
these two bits are significant. 


When D7 is set the MMC1 is reset, most likely initializing the internal serial to 
parallel converter. 


To reset the MMC1 the following code could be used: 


2532 
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LDA #$80 
STA $8000 


e 
é 
e 
‘ 
e 
‘ 
e 
s 


bit 7 set to initialize 

bit 0 not used 

initialize MMC1, any address 
should do 


The MMC1 expects 5 bits of data for every command, therefore five separate writes 


are required to transfer the data. 


To transfer a datum to the MMC1 the following code could be used: 


LDA #$15 
STA $8000 
LSR A 
STA $8000 
isk A 
STA $8000 
LSR A 
STA $8000 
LSR A 
STA $8000 


=e 4. 


=e 


° 
‘ 


e 
a 


e 
co 


bits 0 - 4 data, bit 7 0 
first bit 


second bit 
third bit 
fourth bit 
fifth bit 


Following is a description of each MMC1 register. 


-54- 


> aL Re oe a a oe 


NES PROGRAMMER'S REFERENCE GUIDE 


MMC1 REGISTER 9 


Register 0 is accessed by writing to location $8000. 


76543210 


RODO: Screen Select. 

When ROD1 is in Single Screen Mode 
RODO selects the active screen. 

0 = $2000 - $23FF. 

1 = $2400 - $27FF. 

When ROD1 is in 4 Screen Mode 

RODO selects the scrolling mode. 

0 = Horizontal. 

1 = Vertical. 


ROD1: Screen Mode. . 
0 = Single Screen Mode. 
1 = 4 Screen Mode. 


ROD2: Program Area Mapping. 
When ROD3 is in 32K mode ROD3 
is ignored. Otherwise 

0 = $8000 - S$BFFF. 

1 = $CO00 - $FFFF. 


ROD3: Program Bank Size. 
0 = 32K/per bank. 
1 = 16K/per bank. 


ROD4: Character Bank Size. 
0 = 8K/per bank, 
1 = 4K/per bank. 


RODS: Not Used. 


ROD6: Not Used. 
ROD7: Not Used. 
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MMC1 REGISTER 1 


Register 1 is accessed by betas to location $A000. 

i nos he set to 4K/per bank register 1 selects the lower character bank (PPU 
IF ROD4 is set to 8K/per bank register 1 selects the entire character bank (PPU 
$0000 - $1FFF). 


76543210 


R1D0: Character Address 12. 
Defines CA12 for 4K banks. 
Not used for 8K banks. 


R1D1: Character Address 13. 
Defines CA13 for lower/entire 
character bank. 


R1D2: Character Address 14. 
Defines CA14 for lower/entire 
character bank. 


R1D3: Character Address 15. 
Defines CA15 for lower/entire 
character bank. 


R1D4: Character Address 16. 
Defines CA16 for lower/entire 
character bank. 


R1D5: Not Used. 


R1D6: Not Used. 
R1D7: Not Used. 
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Register 1 is accessed by write to location $C000. 

. ae is set to 4K/per bank register 2 selects the upper character bank (PPU 
1000 - $1FFF). 

IF ROD4 is set to 8K/per bank register 2 is not used. 


765432410 


R2D0: Character Address 12. 
Defines CA12 for upper 
character bank. 


R2D1: Character Address 13. 
Defines CA13 for upper 
character bank. 


R2D2: Character Address 14. 
Defines CA14 for upper 
character bank. 


R2D3: Character Address 15. 
Defines CA15 for upper 
character bank. 


R2D4: Character Address 16. 
Defines CA16 for upper 
character bank. 


R2D5: Not Used. 
R2D6: Not Used. 
R2D7: Not Used. 
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MMC1 REGISTER 3 


Register 3 is accessed by writing to location $E000. 


765432310 


R3D0: Program Address 14. 
Defines PA14 for 16K banks. 
Not used for 32K banks. 


R2D1: Program Address 15. 
Defines PA15 for selected 
program bank. 


R3D2: Program Address 16. 
Defines PA16 for selected 
program bank. 


R3D3: Program Address 17. 
Defines PA17 for selected 
program bank. 

R3D4: Must be set to 1. 
R3D5: Not Used. 


R3D6: Not Used. 
R3D7: Not Used. 
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MULTI MEMORY CONTROLLER 2 


The Multi Memory Controller 2 (MMC2) is a PAL installed on cartridges allowing 
character bank, program bank and scrolling mode selection through software. 


Memory sizes supported are 128K bytes of program ROM and 128K Bytes of 
character ROM. 


Cartridges using the MMC2 include Mike Tyson’s Punch Out. 


1 Ee dad Tah 
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MULTI MEMORY CONTROLLER 3 


The Multi Memory Controller 3 (MMC3) is a custom chip installed on cartridges 
that allows program and character bank selection and size setting. It also allows for 
H/V selection through software. The MMC3 has an internal timer that can be set to 
generated CPU IRQ's. Finally the MMC3 will support extra program RAM. 


Cartridges using the MMC3 include Super Mario Bros. 2. 


The MMC3 allows a maximum program address space of 512K Bytes (PAO - PA18). 
The CPU cartridge 32K memory area is mapped into 4 8K areas. 


External program RAM is supported (8K Bytes mapped at $6000 - $7FFF). 


$A000 MSSR Scroll selection register. 
Bit 0 selects horizontal (0) and 
vertical (1) scrolling. 


$A001 MWPR Write Protect register. 
Bit 7 selects write protect (1) and 
write enable (0). 


$8000 MBRS Bank register select register. 
This register selects one of 7 registers 
that are used to bank select program and 
character banks. 


$8001 MBRV Bank select value register. . 
Writing to this register will write a 
value to the register selected by MBRS. 


MBRS = $80 Character Bank Select Register 0 (CBSRO) 
MBRS = $81 Character Bank Select Register 1 (CBSR1) 
MBRS = $82 Character Bank Select Register 2 (CBRS2) 
MBRS = $83 Character Bank Select Register 3 (CBSR3) 
MBRS = $84 Character Bank Select Register 4 (CBSR4) 
MBRS = $85 Character Bank Select Register 5 (CBRSS5) 
MBRS = $86 Program Bank Select Register 0 (PBSRO) 
MBRS = $87 Program Bank Select Register 1 (PBSR1) 
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MMC3 PROGRAM BANK SELECTION 


The MMC3 supports 512K of program memory. The cartridge program area ($8000 
- $FFFF) is divided into four areas of 8K each. For 512K this gives a total of 64 
banks. 


1 $8000 - $9FFF 
Area 2 $A000 - SBFFF 
3 $C000 - $DFFF 
Area 4 $EO00 - $FFFF 


The memory for area 1 can be bank switched to any 8K segment. Bank selection is 
done through PBSRO. Since 64 banks require 6 bits, only bits 5 through 0 of PBSRO 
are used, Bits 7 and 6 are ignored. 


The memory for area 2 can be bank switched to any 8K segment. Bank selection is 
done through PBSR1. Since 64 banks require 6 bits, only bits 5 through 0 of PBSR1 
are used, Bits 7 and 6 are ignored. 


The memory for area 3 is permanently mapped to bank 63, memory address $7C000 
- §7DFFF. Note that for games with smaller program ROMs (Super Mario II, 128K) 
the upper Dubay ae address bits are not used and area 3 automatically becomes 
mapped to bank 15, memory address $1C000 - $1DFFF. 


The memory for area 4 is permanently ae to bank 64, memory address $7E000 

- $7FFFF. This is the area that should include all 6502 hard vectors. Note that for 

games with smaller program ROMs (Super Mario II, 128K) the upper two program 

address bits are not used and area 3 automatically becomes mapped to b 16, . 
memory address $1D000 - $1FFFF. 


MMC3 PR B ELE NEXAMPL 
Assume it is desired to set up program mapping as follows: 


Area 1 to bank 61, memory address $78000 - $79FFF 
Area 2 to bank 62, memory address $7A000 - S$7BFFF 


PrgBankSel LDY #7 
Bsl TYA 
ORA #$80 
STA $8000 ; do reg select 
LDA BankVals,Y 7 get bank values 
STA $8001 ; save value 
DEY 
CPY #5 
BCS Bsl 
RTS co - 
eee a, be Gg 
Bice ne aes 
. “ous Gl - 


iC A a ee, Ta Mae A eee a ee ea Le ea ee 
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( 
BankVals DB 0,0,0,0,0,0,$3C,$3D 
MMC3 CHARACTER BANK SELECTION 
The MMC3 supports a maximum of 256K of character memory. The cartridge 
character area (50000 - $1FFF) is divided into 6 areas. The first two areas are 2K in 
size, allowing one of 128 banks to be selected, requiring 6 bits for bank selection. 
The remaining areas are 1K in size, allowing one of 256 banks to be selected, 
requiring 7 bits for bank selection. 
Area 1 $0000 - $O7FF Set 1 Character $00 - $7F 
Area 2 $0800 ~- SOFFF Set 1 Character $80 - $FF 
Area 3 $1000 - $13FF Set 2 Character $00 - $3F 
Area 4 $1400 - $17FF Set 2 Character $40 - $7F 
Area 5 $1800 - $1BFF Set 2 Character $80 - SBF 
Area 6 $1C00 - $1FFF Set 2 Character $CO - SFF 
The memory for area 1 can be bank switched to any 2K segment. Bank selection is 
done through CBSRO. Bits 7 through 1 are used to select one of 128 banks. Bit 0 is 
ignored. 
The memory for area 2 can be bank switched to any 2K segment. Bank selection is 
done through CBSR1. Bits 7 through 1 are used to select one of 128 banks. Bit 0 is C 


ignored. 


The memory for area 3 can be bank switched to any 1K segment. Bank selection is 
done through CBSR2. Bits 7 through 0 are used to select one of 256 banks. 


The memory for area 4 can be bank switched to any 1K segment. Bank selection is 
done through CBSR3. Bits 7 through 0 are used to select one of 256 banks. 


The memory for area 5 can be bank switched to any 1K segment. Bank selection is 
done through CBSR4. Bits 7 through 0 are used to select one of 256 banks. 


The memory for area 6 can be bank switched to any 1K segment. Bank selection is 
done through CBSRS. Bits 7 through 0 are used to select one of 256 banks. 


MM HAR R BANK SE N EXAMPLE 
Assume it is desired to set up character mapping as follows: 


Area 1 to 2K bank 16, memory address $08000 - $087FF 
Area 2 to 2K bank 17, memory address $08800 - SO8FFF 
Area 3 to 1K bank 36, memory address $09000 - $093FF 
Area 4 to 1K bank 37, memory address $09400 - $097FF 
Area 5 to 1K bank 38, memory address $09800 - SO9BFF 
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Area 6 to 1K bank 39, memory address $09C00 - SO9FFF 


ChrBankSel LDY #5 
Bsl TYA 
ORA #$80 
STA $8000 
LDA BankVals,Y 
STA $8001 


do reg select 
get bank values 
save value 


-e se SO 


BPL Bsl 
BankVals DB $10,$11,$48,$4A,$4C,$4E 


OTHER TYPES 


Other types I have come across are carts with an MMC type PAL. The general setup 
is similar to a MMC1 cart, but the PAL (labelled ’109”) is wired differently. Program 
and Character bank selection are possible, and so is setting the scrolling mode 
through software. 


Cartridges include Gauntlet and Pac Man, both by Tengen. 


This may be a eae chip or a precursor to the MMC. The chip has no ’NES’ label, 
generates MMC type signals, and seems to be used only by Tengen. 
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GENERAL NES CODE EXAMPLE 


Following is a listing of a fully functional, self contained NES test program. The 
program contains rudimentary code for background and sprite graphics, scrollin 

and sound. This code may be used as a base for understanding practical NE: 

programming. It can be modified by the programmer to better understand some of 
the information contained in this manual. 


The graphics and music for this example where created using the NES hics and 
sound utilities (NICHED, NISPED and NIMCO) and including the resulting 
assembly files in the source. 


ORG $C000 


; 
+ NES Equates 
; 


PCR1 EQU $2000 ; PPU Control Register 1 
PCR2 EQU $2001 * PPU Control Register 2 
PSTR EQU) $2002 ; PPU status register 

PPCR EQU $2003 7 PPU DMA page count 

PSOR EQU) $2005 ; PPU Scrolling Offset Register 
PMAR EQU $2006 ; PPU Memory Address Register 
PMDR EQU $2007 * PPU Memory Data Register 
V1R1 EQU $4000 ; Voice 1 Register 1 

V1R2 EQU $4001 ; Voice 1 Register 2 

V1R3 EQU $4002 ; Voice 1 Register 3 

V1R4 EQU $4003 ; Voice 1 Register 4 

V2R1 EQU $4004 ; Voice 2 Register 1 

V2R2 EQU $4005 ; Voice 2 Register 2 

V2R3 EQU $4006 ; Voice 2 Register 3 

V2R4 EQU $4007 ; Voice 2 Register 4 

V3R1 EQU $4008 ; Voice 3 Register 1 

V3R2 EQU $4009 ; Voice 3 Register 2 

V3R3 EQU $400A ; Voice 3 Register 3 

V3R4 EQU $400B ; Voice 3 Register 4 

V4R1 EQU $400C ; Voice 4 Register 1 

V4R2 EQU $400D ; Voice 4 Register 2 

V4R3 EQU $400E ; Voice 4 Register 3 

V4R4 EQU $400F ; Voice 4 Register 4 

V5R1 _ EQU $4010 ; Voice 5 Register 1 


~~ 


V5R1 
V5R1 
VS5R1 


DPNR 
VMER 


JOY1PORT 
JOY2PORT 


SPRITEYLOC 
SPRITECHAR 
SPRITECOLOR 
SPRITEXLOC 


JOYBUTA 
JOYBUTB 
JOYSEL 
JOYSTART 
JOYUP 
JOYDOWN 
JOYLEFT 
JOYRIGHT 


PCRiInit 


PCR2Init 


JoyiLast 
Joyl1Data 
JoylEdge 
JoylDelay 
ScrnBlank 


CodeState 
SHPCR1 


ShPCR2 
VScroll 
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EQU 


~e Se we 


EQU 
EQU 
EQU 
EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


%10000000 
%01000000 
%00100000 
%00010000 
%00001000 
%00000100 
%00000010 
%00000001 


$10 


$06 


$00 
$01 
$02 
$03 
$04 


™e te we 


~e Se =e %e 


=e me Me we 


se se Se Se Se te te we 


=e te Me 


Voice 5 Register 2 
Voice 5 Register 3 
Voice 5 Register 4 


DMA Page Number Register 
Voice Master Enable Register 


joystick 1 port 
joystick 2 port 


sprite Y loc 

sprite character 
sprite color/mods 
sprite X location 


'A' Button 
'B' Button 
'Select' 
‘Start! 


me Me Me Se Se Me Ne we 


clear scrolling MSB's 

set auto increment to 1 
sprite chars at $0000 - SOFFF 
bkgnd chars at $1000 - $1FFF 
interrupt disabled 

enable color 

blank sprites 

blank background 


Page Zero Variables 


software state 
PCR1 shadow register 


PCR2 shadow register 
vertical scroll offset 
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HScroll EQU $13 ; horizontal scroll offset 


; Sprite working variables 


SprPptr EQU $20 ; ptr to start of sprite def 
SprRow EQU $22 ; sprite row 

Sprcolumn EQU) $23 ? sprite column 

SprRowOfs EQU $24 + row offset in pixels 
Sprcoldfs EQU $25 ; column offset in pixels 
CurrXx EQU $26 7 current X coordinate 

Curry EQU $27 ; current Y coordinate 


sound variables page zero $30 - $7F 


we Me Me 


W_Attackl EQU $30 ; working envelope vars 

W_Attack2 EQU) $31 

W_Attack4 EQU $33 

W_Decay1l EQU $34 

W_Decay2 EQU $35 

W_Decay4 EQU) $37 

W_Sustain1 EQU) $38 

W_Sustain2 EQU $39 C 
W_Sustain4 EQU $3B = 


W_Releasel EQU $3C 
W_Release2 EQU) $3D 
W_Release4 EQU $3F 


W_Durationl EQU $40 ; working duration vars 
W_Duration2 EQU) $41 
W_Duration3 EQU) $42 
W_Duration4 EQU $43 


W_SndTimer EQU $44 


VceLoop EQU $45 
VceInit EQU $47 
VceAdrl EQU $4E 
VceAdr2 EQU $50 
C_VceAdri EQU $54 ; Address of current voice data 
C_VceAdr2 EQU $56 
C_VceAdr3 EQU $58 
C_VceAdr4 EQU $5A 
C_FrqAdr1 EQU $5C ; Address of current freq table 
C_FrqAdr2 EQU  $5E 
C_FrqAdr3 EQU $60 
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C_FrqAdr4 


SoundData 
VceIndex 
VceAdr3 
TempSound 
RestEnable 
SndTemp1 
SndTemp2 


ViAmpWave 
ViSweep 
ViFreqLo 
V1FreqHi 


V2AmpWave 
V2Sweep 
V2FreqLo 
V2FreqHi 


v3entrl 
V3 Dummy 
V3FreqLo 
V3FreqHi 


V4AmpWave 
v4Dummy 
V4FreqLo 
V4FreqHi 


V5Rate 
V5AdrLo 
V5AdarHi 
v5Size 


Attack1 
Attack2 
Attack4 
Decayl 
Decay2 
Decay4 
Sustainl 
Sustain2 
Sustain4 
Releasel 
Release2 


Se Mie hi 


Cass ki a aa 2 eee eae 


ES elie ak Ei ee 
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=e Ne 


: Sound variables $310 - $338 


EQU 
EQU 
EQU 
EQU 


EQU 
EQU 


$0310 
$0311 
$0312 
$0313 


$0314 
$0315 
$0317 
$0318 
$0319 
$031B 
$031¢ 
$031D 
$031F 
$0320 
$0321 


e 
’ 


voice 5 vars 


67% 


pointer to new sound data 
current voice index 


Release4 


SndTimer 
VceEnable 


EnviIndex 
PeakVol 


vViShadow 
SweepShadow 


Temp 
Indo 


RESVector 


Waito 


Waitl 


Wait2 


ForeGround 
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; 
$F8 ; 


CodeState 
HScroll 
vScroll 
VMER 


#PCRIInit 
ShPCR1 
PCR1 
#PCR2Init 
ShHPCR2 
PCR2 
ShHPCR1 
#$80 
ShPCR1 
PCR1 


temporary 
pointer 


; init control registers 


=e Se 


=e Se Se Me 


wait for hardware 
to stabilize 


clear software state 
clear H scroll 

clear V Scroll 

quiet all sound 


; init stack pointer 


; init PCR1 


“eo 


~e 


#SoundStrng & $FF 
#SoundStrng / 256 
; do sound init 


SoundInit 


do nothing 


init PCR2 


enable NMI interrupts 


; in the foreground 
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TRQVector 


NMIVector 
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ForeGround 


PSTR 
ShPCR1 
#$7F 
PCR1 
ShPCR1 


#500 
$2003 


#$02 
DPNR 


ShPCR2 
#$E7 


ShPCR2 
PCR2 


SetUp 


ShPCR2 
#$18 


SNPCR2 
PCR2 


ReadJoy 
DoTest 
SoundRefresh 


HScroll 
PSOR 
vScroll 
PSOR 


SnhPCR1 


me 


=e 


=e ™e Me Me te 


=e 


7e 


=e we we 


=e te 


=e te te 
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should never happen 


save processor registers 


clear interrupt bit 
get PCR1 shadow 
disable interrupts 
save in register 
save in shadow 


Start Sprite DMA 
DMA page number 
get PCR 2 shadow 


blank screen/enable 
CPU access 


screen memory access 
must happen here 


get PCR 2 shadow 


enable screen/block 
CPU access 


read joystick 
execute main code 
update sound 


refresh scroll registers 


get PCR1 shadow 


Ror Bp 2 ORE SEERRUEES 1s EROS Re 


SetUp 


SetUp1 


SetUp2 


DoTest 


TestExit 


ReadJoy 
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#$80 
PCR1 
ShPCR1 


=e Se te 


=e 


peo e's Soe : 


enable interrupts 


save to PPU 


save to shadow 


restore registers 


? actual sprite display code 


LDA 
CMP 
BNE 
JSR 


me te Me 


LDY 


CodeState 
#0 

SetUpl 
Clrchars 
ClrSprites 
ClrScreen 
CodeState 


#1 

SetUp2 
LoadSprites 
LoadScreen 
#$A8 

Currx 

#SA0 

Curry 
CodeState 


CodeState 
#2 
TestExit 
DoCommand 
DrawSprite 


Read controller A 


#1 
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+ load controller 1 


wen 
at 


Pa 


ReadJ1 


ReadJ2 
ReadJ3 


DoCommand 


DoComl 
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STY JOY1PORT 
DEY 

STY JOY1PORT 
LDY #8 

PHA 

LDA JOY1PORT 
STA JoylLast 
LSR A 

ORA JoylLast 
LSR A 

PLA 

ROL A 

DEY 

BNE ReadJ1 
LDY Joyl1Data 
STY JoylLast 
STA Joyl1Data 
EOR JoyliLast 
AND Joyl1Data 
STA JoylEdge 
LDY #$30 

LDA Joyl1Data 
CMP JoylLast 
BNE ReadJ2 
DEC Joyl1Delay 
BNE ReadJ3 
STA Joy1Edge 
LDY #10 

STY Joyl1Delay 
RTS 


me Me Me Ne 


process command if 
joystick pressed 


LDA Joyl1Data 
AND #JOYUP 
BEQ DoComl1 
LDA Curry 
CMP #$16 

Bcc DoCom2 
DEC Curry 
DEC Curry 
JMP DoCom2 
LDA Joy1Data 
AND #JOYDOWN 
BEQ DoCom2 
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-e Se Se Me Se Me Me Ne Me Ne te Ne 


=e 


me te we 


=e ™e te Me BO Te 


shift register 


number of bits 
save new bits 
get next bit(s) 


next bit of data 
fold in first bit 
new bit into carry 
restore new bits 
shift in new bit 
dec bit counter 


; transfer previous data 


° 
e 
e 
e 


=e te 


a) 


=e Me we 


save new data 
debounce it 


delay until repeat 
see if new data 
start new delay 
store repeat value 


delay between 
repeats 


get current data 
if UP 


no 


get Y 
check limit 
at limit 


current data 
if DOWN 


no 


DoCom2 


DoCom3 


DoCom4 


DocCom5 


DoCom6 


DoCom7 


Ve a es eae nes gee ree EU a 
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Curry 
#SB8 
DoCom2 
Curry 
Curry 
JoylData 
#JOYLEFT 
DoCom3 
CurrX 
#$8 
DoCom4 
CurrXx 
CurrX 
DoCom4 
Joyl1Data 
#JOYRIGHT 
DoCom4 
Currx 
#$C8 
DoCom4 
CurrX 
CurrX 
Joyl1Data 
#JOYBUTA 
DoCom5 
HScroll 
#0 
DoCom5 
HScroll 
HScroll 
Joy1Data 
#JOYBUTB 
DoCom6 
HScroll 
#$FE 
Docom6 
HScroll 
HScroll 
Joy1lEdge 
#JOYSTART 
DoCom7 
#1 
SoundStart 


JoylEdge 
#JOYSEL 
DoComs 
#0 


= 995 


“eo Se Se Se Ne Ne Se we Se Se Se Se Se Se Se Ne Se Se Me Ne Me Ne se NO Se Se Se Ne Se Se te Se Se Se Me Me Ne Me MO Me Me Ne Me me “oe we Me WO 


get Y 
check limit 
at limit 


current data 
if LEFT 

no 

get X 

check limit 
at limit 


current data 
if RIGHT 

no 

get X 

check limit 
at limit 


current data 
if ‘A’ 


get horizontal . 


at limit 
yes 


current data 
if 'B! 
get horizontal 


at limit 
yes 


current data 
if 'Start'! 
start sound 


current data 
if 'select' 


eee 6S FE IMS sn Mam eR ROR, 


aba tia cia i 


DoCons 


DrawSprite 


Dsp10 


Dsp14 


Dsp15 


Dsp16 
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JSR 
RTS 


SoundStart 


; draw the sprite 


#<Frame001 
SprPtr 
#>Frameool 
SprPtr+1 
#0 

SprRow 
SprColumn 
SprRowOfs 
SprcolOfs 


Curry 


SprRowOfs 


SPRITEYLOC, 


(SprPtr) ,Y¥ 


X 


SPRITECHAR, X 


(SprPtr) ,Y 


SPRITECOLOR, X 


CurrXx 


SprcolOfs 


SPRITEXLOC, 


Sprcolofs 


#8 
Sprcolofs 
SprColumn 
Sprcolumn 
#6 


SprColumn 
Sprcolo0fs 


X 


ce 


=e we 


=e we te NO 


me “0 te Ne 


se NG Ne Se Me Ne Se Se Ne Ne Me Se Ne Ne Me Ne We Ne Me Se Me Se Me Me Ne Me Ne Ne Me Ne 


stop sound 


point to frame data 


row number 
column number 
row offset 
column offset 


get base Y 


add row offset 

into sprite Y 

get character 

save sprite character 
update index 

get color 


for next pair 
get base X 


add column offset 
save sprite Y 


point to next 
physical sprite 


bump column offset 


see if at edge 
yes 


clear column offset 


Dsp17 


LoadSprites 


Lspro 


Lsprl 
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LDA SprRowO0fs 


ADC #8 
STA SprRowOfs 


CMP #5 
BCS Dsp17 
JMP Dsp10 
RTS 


me te Me Me Me Ne Ne Me Ne TO 


bump row offset 


This routine loads sprites 
from the database to their 


Blocks include sprite colors 


; 

; 

? respective destinations. 
; 

; 


and sprite character definitions 


LDA #<SpriteData ; 


STA Indo 


LDA #>SpriteData 


STA Indo+1 


LDA PSTR 

LDY #$00 

LDA (Indo) ,Y 
STA Temp 

INY 


LDA (IndO) ,Y 
STA Temp+1 


AND Temp 
CMP #$FF 
BEQ LsprxX 
INY 

LDA Temp+] . 
STA PMAR 
LDA Temp 
STA PMAR 
LDA #$00 
SEC 

SBC (Indo) ,Y 
STA Temp 
INY 

LDA #$00 


SBC (Indo) ,Y 
STA Tempt+1 


LDA (Ind0O),Y 
STA  PMDR 


we 


~e 


=e 


=e 


. 
’ 


Laas 


get starting address 
of data 


clear pending interrupts 


dest address low 


dest address high 
done if address 

= SFFFF 

get MSB of dest 
get LSB of dest 


get negative of 
16 bit data count 


transfer actual data 


Se Name aa ie ea ae i ik a a a de ak le a a 
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INY 
BNE Lspr2 
INC Ind0+1 ; bump source 
Lspr2 INC Temp + check counter 
BNE LSpri ; for more data 
INC Tempt+i 
BNE LSprl 
CLC ; update pointer 
TYA ; to next data block 
ADC Indo 
STA Indo 
BCC Lspr4 
INC Ind0+1 
Lspr4 JMP Lspro 
Lsprx RTS 


SpriteData 
DW $0000 ; sprite character set 
DW $0200 + total of 32 characters 


DB $00, $FA,$22,$23,$22,$22,$22,$00 
DB $05,$00,$08,$88,$88,$88,$88,$DD 
DB $00,$5C,$49,$C8,$48,$49, $5C, $00 
DB $A3,$02,$00,$02,$00,$02,$00,$A3 
DB $00,$C1,$20,$80,$40,$20,$C1, $00 
DB $3E,$1C,$0E,$1F,$1F,$0E,$1C,$3E 
DB $00,$CC,$92,$88,$84,$92,$CC, $00 
DB $33,$31,$00,$21,$31,$00,$01,$33 
DB $00,$60,$90,$90,$F0,$90,$90,$00 
DB SOF, SOF,$07,$07,$07,$07,$07,$6F 
DB $00,$33,$4A,$22,$13,$4A,$32,$00 
DB $8c,$80,$00,$80,$80,$00,$80,$CD 
DB $00,$9C,$52,$52,$9C,$12,$12,$00 
DB $63,$01,$00,$00,$01,$40,$C0, $ED 
DB $00, SEF,$42,$42,$42,$42,$E2,$00 
DB $10,$00,$10,$18,$18,$18,$08,$1D 


DB $00,$BC,$20,$38,$20,$20,$3C, $00 
DB $43,$01,$01,$83,$87,$83,$81,$C3 
DB $00,$00,$00,$00,$03,$07,$07,$0F 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $00,$00,$10,$38,$FC,SFF,$FF,$FF 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $00,$00,$00,$00,$E7,$FF,$FF,$FF 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $00,$OF,$1F,$3F,$FF,$FF,$FF,$FF 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $00,$80,$C0,$E0,$F1,$F3,$F7,$FF 


«15x 


NES PROGRAMMER'S REFERENCE GUIDE 


DB 
DB 
DB 
DB 
DB 


DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 


DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 


DW 
DW 
DB 
DB 
DB 
DB 


DB 


$00,$00,$00,$00,$00, $00, $00,$00 
$00,$00,$38,$78,$FC,$FC,SFE,$¥FC 
$00,$00,$00,$00,$00,$00,$00,$00 
$F8,SF8,SE8,SFO,$E0, $€0, $E0,$FO 
$00,$00,$00,$00,$00,$00,S00, $00 


$FO,SFC,$FC,$FC,$FC,SFC,$F0,$F9 
$00,$00,$00,$00,$00,$00,$00,$00 
$FO,$FO,SF0,$F0,SF0,$F0,$F8,S$F8 
$00, $00, $00, $00, $00.$00,$00,$00 
SFO,SF8,SFC,$FE,$FE,$7E,$7E,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
SFF,SFF,SFF,SFF,$FF,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
SFF,SFF,SFF,$7F,$7F,$7C,$3C, $18 
$00,$00,$00,$00,$00,$00,$00,$00 
SFF,SFF,SFF,S$F8,$F0,$E0,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
SFF,SFF,SFF,$F7,$F3,$F1,$F0,$E0 
$00,$00,$00,$00,$00,$00,$00,$00 
$1F,$1F,$1F,S0F,$07,$03,$01,$00 
$00,$00,$00,$00,$00,$00,$00,$00 


$1F,$1F,$1F,$1F,$03,$07,$0F,$1F 
$00,$00,$00,$00,$00,$00,$00,$00 
$3F,$1F,SOF,$1F,$3F,$1F,$0F,$1F 
$00,$00,$00,$00,$00,$00,$00,$00 
$1F,$1F,S0F,$07,$07,$07,$0F,$1F 
$00, $00, $00, $00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
SFF,SFF,SFF,$FF,SFF,SFF,SFF,$FF 
$00,$00,$00,$00,$00,$00,$00,$00 
SFF,SFE,S$FE,$FE,$FE,$FE,$FE,$FF 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 


$3F10 7 colors 
$0010 

SOF,$10,$07,$1¢C 
SOF,$07,$04,$08 
$OF,$00,$2D,$11 
SOF,$29,$2C,$26 


SFF,SFF 
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DB SFF,SFF 
; Frame Data [Sprite#,Sprite Color/Flip] 


Frameool _ DB $09,$01,$0A,$01,$0B,$01 
DB $0C,$01,$0D,$01,$0E,$01 
DB $1A,$01,$00,$00,$01,$00 

DB $02,$00,$03,$00,$0F,$01 

DB $19,$01,$1B,$00,$1C,$00 

DB $04,$00,$1B,$00,$10,$01 

DB $18,$01,$05,$00,$06,$00 

DB $07,$00,$08,$00,$11,$01 

DB $17,$01,$16,$01,$15,$01 

DB $14,$01,$13,$01,$12,$01 

DB SFF,$00,$FF,$00,$FF,$00 

BD SFF,$00,$FF,$00,$FF,$00 


; This routine will transfer blocks 
+ from the database to their 

; respective destinations. 

# Blocks include Background screen, 
+ color and character definitions 


LoadScreen LDA #<ScreenData ; get starting address 
STA Indo ; of data 
LDA #>ScreenData 
STA Indo+1 

Lscro . LDA PSTR 7 Clear pending interrupts 
LDY #$00 
LDA (IndO) ,Y ; dest address low 
STA Temp 
INY ie 
LDA (Indo) ,Y ; dest address high 
STA Temp+1 
AND Temp ; done if address 
CMP #SFF ; = $FFFF 
BEQ Lscrx 
INY 
LDA Temp+1 + get MSB of dest 
STA PMAR 
LDA Temp ; get LSB of dest 
STA PMAR 
LDA #$00 ; get negative of 
SEC ; 16 bit data count 


SBC (IndO),Y 
STA Temp 


Pe Re RIDER ED E SE ee RS SERUM 


CER RESET MS Ty STM ger 8 Ae gM BEER RON Meee Ree eS! Sec ey Re Reena Pe 4 ere 
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LDA #$00 
SBC (Indo) ,Y 
STA Temp+1 


INY 
Lscrl1 LDA (IndO) ,Y ; transfer actual data 
STA PMDR 
INY 
BNE Lscr2 
INC Indo0+1 ; bump source 
Lscr2 INC Temp ; Check counter 
e 


BNE LScrl1 for more data 
INC Temp+1 


BNE LSerl1 


CLC ; update pointer 

TYA 3; to next data block 
ADC Indo 

STA Indo 


BCC Lscr4 
INC Ind0+1 


Lscr4 JMP Lscro 

Lscrx RTS 

ScreenData C 
DW $1000 ; character set 
DW $0300 


DB $38,$4C,$C6,$C6,$C6,$64,$38,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $18,$38,$18,$18,$18,$18,$7E,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $7C,$C6,$0E,$3C,$78,$E0,$FE,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $7E,$0C,$18,$3C,$06,$C6,$7C,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $1C,$3C,$6C,$CC, $FE,$0C,$0C,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB SFC,$CO,$FC,$06,$06,$C6,$7C,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $3C,$60,$C0,$FC,$C6,$C6,$7C,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB SFE,$C6,$0C,$18,$30,$30,$30,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 


DB $7¢,$C6,$C6,$7C,$C6,$C6,$7C, $00 
DB $00,$00,$00,$00,$00,$00,$00, $00 
DB $7C,$C6,$C6,$7E,$06,$0C, $78, $00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
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DB $38,$6C,$C6,$C6,$FE, $C6,$C6, $00 
DB $00,$00,$00,$00,$00, $00, $00, $00 
DB SFC, $C6,$C6,$FC,$C6, $C6, $FC, $00 
DB $00,$00,$00,$00,$00,$00,$00, $00 
DB $3C,$66,$C0,$C0,$C0,$66,$3C, $00 
DB $00,$00,$00, $00, $00, $00, $00, $00 
DB $F8,$CC,$C6,$C6,$C6,$CC, $F8, $00 
DB $00, $00,$00, $00, $00, $00, $00, $00 
DB SFE,$C0,$C0,$FC,$C0,$C0, $FE, $00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB S$FE,$C0,$C0,$FC,$C0,$C0,$C0, $00 
DB $00,$00,$00,$00,$00, $00, $00, $00 


DB $3E,$60,$C0,$CE,$C6,$66,$3E, $00 

DB $00,$00,$00,$00,$00, $00, $00, $00 

DB $C6,$C6,$C6,$FE,$C6,$C6,$C6, $00 

DB $00,$00,$00,$00,$00, $00, $00, $00 

DB $7E,$18,$18,$18,$18,$18,$7E, $00 

DB $00,$00,$00,$00,$00, $00, $00, $00 

DB $1E,$06,$06,$06,$C6,$C6,$7C, $00 

DB $00,$00,$00,$00,$00,$00, $00, $00 

DB $C6,$CC,$D8,$F0,$F8,$DC, $CE, $00 

DB $00,$00,$00,$00,$00, $00, $00, $00 
& DB $60,$60,$60,$60,$60,$60,$7E, $00 
: DB $00,$00,$00,$00,$00, $00, $00, $00 
DB $C6,$EE,$FE,$FE,$D6,$C6,$C6,$00 

DB $00,$00,$00,$00,$00,$00,$00, $00 

DB $C6,SE6,$F6,$FE,$DE,$CE,$C6,$00 

DB $00,$00,$00,$00,$00,$00, $00, $00 


DB $7C¢,$C6,$C6,$C6,$C6,$C6,$7C, $00 
DB $00,$00,$00,$00,$00, $00, $00, $00 
DB SFC,$C6,$C6,$C6,$FC,$C0,$C0,$00 
DB $00,$00,$00,$00,$00,$00,$00, $00 
DB $70,$C6,$C6,$C6,$DE,$CC,$7A, $00 
DB $00,$00,$00,$00,$00,$00,$00, $00 
DB SFC, $C6,$C6,SCE,$F8,$DC, $CE,$00 
DB $00,$00,$00,$00,$00,$00,$00,$00 
DB $78,$CC,$C0,$7C,$06,$C6,$7C, $00 
DB $00,$00,$00,$00,$00, $00, $00, $00 
DB $7E,$18,$18,$18,$18,$18,$18,$00 
DB $00,$00,$00,$00,$00,$00, $00, $00 
DB $c6,$C6,$C6,$C6,$C6,$C6,$7C, $00 
DB $00,$00,$00,$00,$00, $00, $00, $00 
DB $c6,$C6,$C6,$EE,$7C,$38,$10,$00 
DB $00,$00,$00,$00,$00, $00, $00, $00 


DB $C6,$C6,$D6,$FE,$FE,$EE,$C6,$00 


-79 - 


NES PROGRAMMER'S REFERENCE GUIDE 


$00,$00,$00,$00,$00,$00,$00,$00 
$C6, SEE, $7C,$38,$7C, SEE, $C6,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$66,$66,$66,$3C,$18,$18,$18,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$FE,$0E,$1C,$38,$70,$E0,$FE, $00 
$00,$00,$00,$00,$00,$00,$00,$00 
$18,$18,$18,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00, $00 
$66 ,$FF,$FF $66,$66,SFF,SFF,$66 
1S 7400, $00, $00,$00,$00,$00, $00 

00, $00,$00, $00,$00,$00,$00,$00 
$oo, 00, $00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00, $00, $00 


$00,$00,$00,$00,$00, $00, $00, $00 
$00,$00,$00,$00,$00, $00, $00, $00 
SFE, SFE,$06,$06,$E6, $E6, $66, $66 
$00,$00,$00,$00,$00, $00, $00, $00 
SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
$00,$00,$FF,$FF,$00,$00,$FF, $FF 
$7F,$7F,$60,$60,$67,$67,$66, $66 
$00,$00,$00,$00,$00,$00,$00, $00 
$66,$66,$66,$66,$66,$66,$66,$66 
$00,$00,$00,$00,$00,$00, $00, $00 
$66,$66,$E6,$E6,$06,$06,$FE,$FE 
$00,$00,$00,$00,$00,$00,$00, $00 
SFF,SFF,S$FF,SFF,$FF,$FF,$FF,$FF 
SFF,SFF,$00,$00,SFF,$FF,$00,$00 
$66,$66,$67,$67,$60,$60,$7F,$7F 
$00,$00,$00,$00,$00,$00,$00,$00 


$3F00 ; colors 
$0010 

SOF,$28,$08,S0F 
SOF,$11,$19,$0F 
SOF,$00,$2D,$0F 
SOF,$26,$2C,$0F 


$2000 ; character map screen 1 
$400 

SFF,SFF,S$FF,SFF,S$FF,$FF,S$FF,$FF 
SFF,SFF,SFF,SFF,SFF,SFF,S$FF,$FF 
SFF,SFF,SFF,S$FF,S$FF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,S$FF,SFF,$FF,$FF 
SFF,SFF,S$FF,SFF,$FF,S$FF,SFF,S$FF 
SFF,SFF,SFF,$FF,SFF,SFF,SFF,$FF 
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SFF,SFF,SFF,S$FF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,$FF,$FF,SFF,$FF,$FF 
$9B,$9B,$2B,$2A,$2A,$2A,$2A,$2A 
$2A,$2A,$2A,$2A,$2A,$2A,$2A,$2A 
$2A,$2A,$2A,$2A,$2A,$2A,$2A,$2A 
$2A, $2A, $2A, $2A, $2A, $29 , SCA, SCA 
SFF,SFF,$2C,$FF,$FF,$FF,$FF, $FF 
SFF,SFF,SFF,$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$2C,$FF, $FF 
SFF,SFF,$2C,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,$FF,SFF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$2C, $FF, $FF 
SFF,SFF,$2C,$FF,SFF,$17,$12,$17 
$1D,$0E,$17,$0D,$18, $FF, $0E, $21 
$0A,$16,$19,$15,S0E, $FF,$0C, $18 
$OD, SOE, $FF,S$FF,$FF,$2C, $FF, $FF 
SFF,SFF,$2C,SFF,$D0,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,S$FF,$FF,$FF 
SFF,SFF,$FF,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,SFF,S$FF,SFF,$2C,$FF, $FF 
SFF,SFF,$2C,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,$FF,SFF,$FF,$FF,$FF,$FF 
SFF,$FF,$FF,$FF,SFF,$FF,$FF,$FF 
SFF,SFF,$FF,$FF,$FF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,$FF,$0B,$22,$FF 
$1¢,$0C,$1E,$15,$19,$1D,$1E,$1B 
$0E,$0D,$FF,$1C,$18,$0F,$1D, $20 
$OA,$1B,$0E,SFF,SFF,$2C, $FF, $FF 
SFF,S$FF,$2C,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,$FF,S$FF,$FF,$FF,$FF,$FF 
SFF,SFF,$FF,$FF,$FF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,$FF,$FF,$FF,$FF,$FF,$FF 
$D6,$D6,$FF,$FF,$FF,$2C,$FF, $FF 
SFF,SFF,$2C,$FF,S$FF,$13,$18,$22 
$1C,$1D,$12,$0C,$14,$FF,$1D,$18 
SFF,$16,$18,$1F,$0E,$FF,$1C,$19 
$1B,$12,$1D,$0E,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,S$FF,S$FF,S$FF,SFF,$FF,$FF 
SFF,SFF,$FF,$FF,SFF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,SFF,$FF,$24 
$0A,$24,$FF,$1D,$18,$FF,$1C,$0C 
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$1B,$18,$15,$15,$FF,$15,$0E, $OF 
$1D,$FF,$FF,$FF,S$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,$FF,$FF,$FF 
SFF,S$FF,S$FF,S$FF,$FF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
SFF,S$FF,SFF,SFF,$FF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,S$FF,$FF,$FF,$24 
$0B,$24,$FF,$1D,$18,$FF,$1C,$0C 
$1B,$18,$15,$15,$FF,$1B,$12,$10 
$11,$1D,$FF,$FF,SFF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,$A6,$A6,$A6, $FF 
SFF,$FF,SFF,S$FF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,SFF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,SFF,$FF,SFF,$FF, $24 
$1C,$1D,$0A,$1B,$1D,$24,$A6,$0F 
$18,$1B,S$FF,$16,$1E,$1C,$12,$0C 


. $FF,SFF,SFF,SFF,$FF,$2C,$FF,$FF 


SFF,$FF,$2C,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,SFF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,$FF,$24,$1C 
SOE,$15,$0E,$0C,$1D,$24,$FF,$0F 
$18,$1B,$FF,$1C,$12,$15,$0E,$17 


 $0C,$0E,$FF,$FF,$FF,$2C,$FF,$FF 


SFF,SFF,$2C,$FF,S$FF,SFF,$FF,$FF 
SFF,SFF,$FF,$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,SFF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,SFF,$2C,$FF,$FF 
SFF,S$FF,$2C,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,$FF,S$FF,SFF,$FF,$FF,$FF 
SFF,SFF,$FF,$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,SFF,$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,$FF,$FF,$FF 
SFF,SFF,$FF,S$FF,SFF,SFF,$FF,$FF 
SFF,SFF,S$FF,S$FF,SFF,$FF,S$FF,$FF 
SFF,SFF,S$FF,$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,$FF,S$FF,S$FF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,S$FF,S$FF,SFF,$FF,S$FF 
SFF,SFF,$FF,$FF,SFF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,$FF,S$FF,SFF,$FF,$FF,$FF 


oRD 


eR SS tat, 
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SFF,SFF,SFF,SFF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,S$FF,$2C,$FF,$FF 
SFF,SFF,$2C,SFF,S$FF,SFF,$FF,$FF 
SFF,SFF,$FF,$1C,$0C,$1B,$0E,$0E 
$17,$FF,$25,$01,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,S$FF,$2C,$FF,$FF 
SFF,SFF,$2F,$2E,$2E,$2E,$2E,$2E 
$2E,$2E,$2E,$2E,$2E,$2E,$2E,$2E 
$2E,$2E,$2E,$2E,$2E,$2E,$2E,$2E 
$2E,$2E,$2E,$2E,$2E,$2D,$FF,$FF 
$FF,SFF,$D0,$D0,$D0,$D0,$D0,$D0 
$D0,$D0,$D0,$D0,$D0,$D0,$D0,$D0 
$D0,SFF,SFF,SFF,S$FF,SFF,SFF,$FF 


‘$FF,SFF,SFF,SFF,$FF,$D0,$FF,$FF 


SFF,$FF,$D0,$D0,$D0,$D0,$D0, $DO 
$D0,$D0,$D0,$D0,$D0,$D0, $D0, $DO 
$D0,$D0,$D0,$D0,$D0,$D0, $D0, $DO 
$D0,$D0,$D0,$D0,$D0,$D0, $FF, $FF 


$00,$00,$00,$00,$00,$00,$00,$00 
$00,$55,$55,$99, SAA, SEE, $33, $00 
$00, SAA, SAF, SAF, $A7,$A5,$A5, $00 
$00,$42,$50,$50,$50,$50,$18,$00 
$00, $8C, SAF, SAF, SAF, SAF, $21, $00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 
$00,$00,$00,$00,$00,$00,$00,$00 


$2400 ; Character map 


SFF,S$FF,S$FF,$FF,$FF,$FF,$FF,$FF 
SFF,$FF,$FF,SFF,SFF,S$FF,$FF,$FF 
SFF,SFF,S$FF,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,S$FF,SFF,SFF,$FF,$FF,$FF 
SFF,S$FF,SFF,S$FF,$FF,$FF,$FF,$FF 
SFF,S$FF,$FF,S$FF,SFF,$FF,$FF,$FF 
SFF,$FF,$FF,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,SFF,$FF,$FF,$FF 
$9B,$9B,$2B,$2A,$2A,$2A,$2A,$2A 
$2A,$2A,$2A,$2A,$2A,$2A,$2A,$2A 
$2A,$2A,$2A,$2A,$2A,$2A,$2A,$2A 
$2A,$2A,$2A,$2A,$2A,$29,$CA,$CA 
SFF,SFF,$2C,S$FF,SFF,S$FF,$FF,$FF 
SFF,SFF,$FF,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,$FF,$FF,SFF,$FF,$FF,$FF 
SFF,SFF,$FF,S$FF,SFF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,$FF,S$FF,$FF 
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SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,SFF,SFF, $FF 
SFF,SFF,SFF,SFF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,$17,$12,$17 
$1D,$0E,$17,$0D,$18,$FF,$0E,$21 
$0A,$16,$19,$15,S$0E, $FF,$0C,$18 
$0D,$0E,$FF,SFF,$FF,$2C, $FF,$FF 
SFF,SFF,$2C,$FF,$D0,$FF,SFF, $FF 
SFF,SFF,SFF,$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$2C,$FF,$FF 
SFF,SFF,$2C,S$FF,$FF,$FF,S$FF,$FF 
SFF,SFF,SFF,$FF,SFF,$FF,$FF,$FF 
SFF,SFF,SFF,S$FF,S$FF,$FF,$FF,$FF 
$FF,SFF,SFF,$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,$0B,$22,$FF 
$1¢,$0C,$1E,$15,$19,$1D,$1E,$1B 
$0E,$0D,$FF,$1C,$18,$0F,$1D, $20 
$0A,$1B,S0E,$FF,$FF,$2C, $FF,$FF 
SFF,S$FF,$2C,$FF,$FF,SFF,$FF,$FF 
SFF,S$FF,$FF,SFF,$FF,$FF,$FF,$FF 
SFF,$FF,$FF,$FF,SFF,$FF,$FF,$FF 
SFF,S$FF,SFF,SFF,SFF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,$FF,S$FF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,S$FF,$FF,$FF,$FF 
$D6,$D6,$FF,$FF,$FF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,$FF,$13,$18,$22 
$1C,$1D,$12,$0C,$14,$FF,$1D,$18 
SFF,$16,$18,$1F,$0E,$FF,$1C,$19 
$1B,$12,$1D,S0E,$FF,$2C,$FF, $FF 
SFF,SFF,$2C,S$FF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,SFF,$FF,$FF,$FF 
SFF,SFF,S$FF,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,$FF,$2C,$FF,$FF 
SFF,S$FF,$2C,S$FF,$FF,$FF,$FF,$24 
$0A,$24,$FF,$1D,$18,$FF,$1C,$0C 
$1B,$18,$15,$15,$FF,$15,$0E,$0F 
$1D,$FF,$FF,$FF,$FF,$2C,$FF,$FF 
SFF,$FF,$2C,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$FF,$FF,$FF 
SFF,S$FF,S$FF,SFF,$FF,$FF,$FF,$FF 
SFF,S$FF,SFF,S$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,$FF,$FF,$24 
$0B,$24,$FF,$1D,$18,$FF,$1C,$0C 
$1B,$18,$15,$15,$FF,$1B,$12,$10 
$11,$1D,$FF,$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SA6,$A6,$A6,$FF 
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SFF,SFF,SFF,S$FF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,SFF,$FF,SFF 
SFF,SFF,SFF,S$FF,S$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,SFF,$FF,$24 
$1C,$1D,$0A,$1B,$1D,$24,$A6,SO0F 
$18,$1B,$FF,$16,$1E,$1C,$12,$0C 
SFF,SFF,S$FF,$FF,$FF,$2C,SFF,S$FF 
SFF,SFF,$2C,$FF,$FF,S$FF,SFF,$FF 
SFF,SFF,S$FF,S$FF,S$FF,S$FF,SFF,$FF 
SFF,SFF,SFF,SFF,S$FF,$FF,S$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,SFF,$24,$1C 
$0E,$15,$0E,$0C,$1D,$24,$FF,$0F 


' $18,$1B,$FF,$1C,$12,$15,$0E,$17 


$0C,$0E,SFF,$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,SFF,SFF,$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,S$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,S$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,SFF,S$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,SFF,S$FF,$FF 
SFF,SFF,SFF,SFF,SFF,S$FF,$FF,$FF 
SFF,SFF,SFF,SFF,S$FF,$2C,S$FF,$FF 
SFF,SFF,$2C,SFF,S$FF,SFF,$FF,$FF 
SFF,SFF,$FF,S$FF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,$FF,SFF,S$FF,$FF,$FF 
SFF,SFF,$FF,$FF,SFF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,S$FF,$FF,$FF 
SFF,SFF,SFF,SFF,SFF,$FF,S$FF,$FF 
SFF,SFF,$FF,$FF,$FF,SFF,$FF,$FF 
SFF,$FF,$FF,$FF,$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,SFF,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,S$FF,$FF,$FF,$FF 
SFF,SFF,$FF,S$FF,S$FF,$2C,$FF,$FF 
SFF,SFF,$2C,$FF,S$FF,SFF,$FF,$FF 
SFF,SFF,$FF,$FF,$FF,SFF,$FF,$FF 
SFF,SFF,S$FF,$FF,$FF,$FF,$FF,$FF 
SFF,SFF,S$FF,S$FF,$FF,$2C,$FF,$FF 
SFF,S$FF,$2C,$FF,$FF,SFF,$FF,$FF 
SFF,$FF,$FF,$1C,$0C,$1B,$0E,$0E 
$17,$FF,$25,$02,$FF,$FF,S$FF,$FF 
SFF,SFF,$FF,$FF,S$FF,$2C,$FF, $FF 
SFF,SFF,$2F,$2E,$2E,$2E,$2E,$2E 
$2E,$2E,$2E,$2E,$2E,$2E,$2E,$2E 
$2E,$2E,$2E,$2E,$2E,$2E,$2E,$2E 
$2E,$2E,$2E,$2E,$2E,$2D,$FF, $FF 
SFF,SFF,$D0,$D0,$D0,$D0, $D0, $DO 
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ClrScreen 


ClrScreeno 


ClrChars 
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$D0,$D0,$D0,$D0,$D0, $D0, $D0, $DO 
$D0, $FF,SFF,$FF,SFF,SFF,$FF,$FF 
SFF,SFF,SFF,SFF,$FF,$D0,$FF,$FF 
SFF,$FF,$D0,$D0,$D0,$D0,$D0, $DO 
$D0,$D0,$D0,$D0,$D0,$D0, $D0, $D0 
$D0,$D0,$D0,$D0, $D0, $D0, $D0, $DO 
$D0,$D0,$D0,$D0,$D0,$D0, $FF, $FF 


$40,$50,$50,$50,$50, $50, $50, $10 
$44,$5F,$5F,$97,$A5,$E9,$32,$11 
$44,$00,$05,$05,$09,$0A, $0A, $11 
$44,$86,$A5,$A5,$A5,$A5,$29,$11 
$44,$C0,$F0,$F0,$F0,$F0,$31,$11 
$44,$00,$00,$00,$00,$00,$00,$11 
$44,$50,$50,$50,$50,$50,$50,$11 
$00,$00,$00,$00,$00, $00, $00, $00 


SFF,SFF 


; 
7; clear the screen 
; 


me te 


LDA 
STA 
LDA 
STA 
LDA 
TAX 


#$20 : dest MSB = $20 

PMAR 

#0 ; dest LSB = $00 

PMAR 

#$00 

#$00 

#SFF 

PMDR ; store character 
+ $400 times 

ClrScreeno 


#$04 
ClrScreeno 


Clear the background 
character set area 
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TAY 
Clrch STA  PMDR 

INX 

BNE ClrCh 
LDA PSTR 

INY 

CPY #$10 

BNE ClrCh 
RTS 


+ clear the sprite 
; character area 


ClrSprites LDA #$00 set up sprite 


STA PMAR ; character 
LDA #$00 ; address 

STA PMAR ; 

LDA. #0 ; clear indices 
TAX ; 

TAY ; 

ClrSp STA PMDR ; store a 0 
INX ; 

BNE ClrSp ; 
INY ; 
CPY #$10 ; 
BNE Clrsp ; 
LDX #0 ; 
TXA ; 

ClrSpl STA  SPRITEYLOC,X ; make sprite 
INX ; disappear 
INX ; 

INX ; 
INX ; 
BNE ClrSpl ; 
RTS ; 


; 
+ Sound Driver 
; 


SndInit JMP SoundInit 
SndRefresh JMP SoundRefresh 
SndStart JMP SoundStart 


; Init all sound registers 
; Pass address of sound table in x,y 


SoundInit LDA #SOF 7 enable voices 
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'& 

STA  VMER 
LDA #$coO 

STA JOY2PORT 
LDA #$FO 

STA V1R1 

STA V3R2 

STA V4R1 

LDA = #$80 

STA V3R1 

LDA #878 

STA V1R2 

STA V2R2 

STA V3R2 

STA V4R2 

LDA #$F0 

STA V1R3 

STA V2R3 

STA V3R3 

STA V4R3 

LDA  #$08 

STA V1R4 

STA V2R4 

STA V3R4 

STA V4R4 C 
LDA #$00 


STA RestEnable 
STA W_SndTimer 
STA SndTimer 
STA VceEnable 
STA VceLoop 
STA VceLoop+l1 
STA VceLoop+2 
STA VceLoop+3 
STA VceInit 
STA VceInitt+1 
STA VceInit+2 
STA VceInit+3 
STX SoundData 
STY SoundData+1 


; Load a single voice with data 


LoadVoice LDX VceIndex 
LDA #$01 
STA VceInit,X 
RTS 
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LoadInit 


LoadCntrl 
LDC1 


LDC2 


BitTest 


INTAB 


SoundStart 


SNDST1 
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LDA #$00 

STA VeeInit,X 
LDA ViSweep,Y 
STA V1R2,Y 

LDA V1FreqLo,Y 
STA V1R3 ,Y 

LDA V1FreqHi,Y 
STA V1R4,Y 
JMP LDC2 


; load voice controller register 
LDX #$00 


LDA BitTest,X 
AND VceEnable 


BEQ LDC2 
AND RestEnable 
BNE LDC2 


LDY INTAB,X 
LDA ViAmpWave, Y 
STA V1R1,Y 

LDA VceInit,X 
BNE LoadInit 


INX 
CPX #$04 
BCC LDC1 
RTS 


DB $01,$02,$04,$08,$10 
DB $00,$04,$08,$0C,$10 


7; Start a new sound 


ASL A 

TAY 

LDA (SoundData) ,Y 
STA VceAdrl 


LDA (SoundData) ,Y 
STA VceAdri1+1 

LDY #0 

LDA (VceAdri) ,Y 
BMI SndStx 


AND #$03 

STA VceIndex 
TAX 

LDA #$00 


STA EnviIndex, X 
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SNDST2 
SndStx 


GetData 


GData 


DocCmnd 
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BitTest,X 
VceEnable 
VceEnable 
A 
(VceAdr1) ,Y 
C_VceAdr1,X 


(VceAdr1) ,Y 


C_VceAdri+1,xX 


(VceAdr1) ,Y 
C_FrqAdr1,X 


(VceAdr1) ,Y 


C_FrqAdri+1,X 


GetData 


#5 


VceAdr1 
VceAdrl1 
SNDST2 
VceAdrit+1 
SndSt1 


Sound Data 


VceIndex 
A 


C_VceAdr1,X 
VceAdr2 


C_VceAdr1+1,X 


VceAdr2+1 
#$00 
(VceAdr2) ,Y¥ 
DoCmnd 
StartNote 
NewAdr 


; Process command 


AND 
LSR 
LSR 


#$70 
A 
A 
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LSR A 
LSR A 
CMP #7 
BEQ DCMD9 
PHA 

ASL A 
TAX 


LDA CommandTab, X 
STA VceAdr3 

LDA CommandTab+1,X 
STA VceAdr3+1 

JSR CndJump 


CMP #3 
BEQ NewAdr 
JMP GData 


3; Store new data address 


NewAdr LDA VceIndex 
ASL A 
TAX 


LDA VceAdr2 

STA C_VceAdr1,X 

LDA VceAdr2+1 

STA C_VceAdriti1,X 
DCMD9 RTS 


CndJump IMP (VceAdr3) ; jump to command 


CommandTab DW SET_ENVL 
DW SET_CLICKS 
DW QUIT_VOICE 
DW REST_VOICE 
DW LOOP_VOICE 


pass envelope data 
pass jiffies/count 
done with voice 

get duration of rest 
loop destination 

and count 


me te te Me NO Me 


DW Dummy 
DW Dummy 
DW Dummy 
DW Dummy 


Dummy RTS 

LOOP_VOICE INY 
LDA (VceAdr2) ,Y 
STA SndTemp2 


LDA (VceAdr2),Y 


oN 
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CNTON 


LpAdr 


ENDLOOP 


StartNote 
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STA SndTemp2+1 


LDX VceIndex 
LDA VceLoop, X 
BNE CNTON 

LDA (VceAdr2) ,Y 
STA VceLoop, X 
DEC VceLoop, X 
BEQ ENDLOOP 
LDA SndTemp2 
STA VceAdr2 
LDA SndTemp2+1 
STA VceAdr2+1 


RTS 

LDA #4 

JSR ADDVceAdr2 
RTS 

LDX VceIndex 
PHA 

LDA BitTest,xX 
EOR #SFF 


AND RestEnable 
STA RestEnable 


PLA 

AND #$1F 

ASL A 

STA W_Duration1,X 
TXA 

ASL A 

TAX 


LDA C_FrqAdr1,X 
STA VceAdr3 

LDA C_FrqAdri1+1,X 
STA VceAdr3+1 
ASL A 


CPX #12 
BEQ DOVCc3 


LDA (VceAdr2) ,Y 
A 

LDA (VceAdr3) ,Y 

STA V1FreqLo,xX 


LDA (VceAdr3) ,Y 


STBACK 


STNOTES 


Dovc3 


SET_CLICKS 


QUIT _VOICE 
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V1FreqHi,xX 


VceIndex 

#2 

STNOTES 
Attackl1,xX 
W_Attackl1,X 
Decay1,X 
W_Decayl1,X 
Sustain1,X 
W_Sustain1,X 
Releasel,X 
W_Releasel,X 


A 
A 


ViShadow, X 
VilAmpWave, Y 
SweepShadow, X 
ViSweep,Y 
#$00 
EnviIndex, X 

#2 

ADDVceAdr2 
LoadVoice 


(VceAdr2) ,Y 
V1FreqLo,X 
#$00 
V1FreqHi,X 
STBACK 


(VceAdr2) ,Y 
SndTimer 
W_SndTimer 
#2 
ADDVceAdr2 


#$01 
ADDVceAdr2 
VceIndex 
BitTest,X 
#$FF 


oe 


QTVOICE 


QT2 


REST_VOICE 


SET_ENVL 
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VceEnable 
VceEnable 


INTAB, X 


#8 

QT2 
ViAmpWave,X 
#$FO 
ViAmpWave, X 
V1R1,X 


#$80 
VlAmpWave , X 
V1R1,X 


VceIndex 
QTVOICE 
VceIndex 
BitTest,xX 
RestEnable 
RestEnable 
(VceAdr2) ,Y 
#$0F 
W_Duration1,xX 
#1 
ADDVceAdr2 


VceIndex 
#2 
STENV9 


SndTemp1 
A 
A 


(VceAdr2) ,Y 
#$03 


WVE,Y 
ViAmpWave,X 
SndTemp1 


(VceAdr2) ,Y 
#SOF 
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ENVTAB 


DO_Release 


DOR1 


DOR 
DO_ Attack 


ATK1 


ATK9 


DO_Decay 
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TempSound 


VilAmpWave,X 


SndRefresh3 
(VceAdr3) 


DO_Attack 
DO_Decay 
DO_Sustain 
DO_Release 


TempSound 


#S0F 
DOR9 


Releasel,X 
DOR1 

#$00 
SndTemp1 
TempSound 
#$FO 
SndTemp1 
TempSound 


TempSound 
#S$0F 
Peakvol,X 
ATK9 


W_Attack1,X 


PeakVol,X 
ATK1 
PeakVol,X 
SndTemp1 
TempSound 
#$FO 
SndTemp1 
TempSound 


#$01 
Envindex, X 


W_Decay1,X 
DOD2 
TempSound 
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DOD2 


DO_Sustain 


DOs1 


SoundStrng 


Sndo 


Sndl 
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AND #S$O0F 

BEQ DODS 

DEC TempSound 
DEC W_Decay1,X 


RTS 

LDA #2 

STA  EnvIndex,X 
RTS 

DEC W_Sustain1,X 
_BPL DOS1 

RTS 

LDA #3 

STA EnvIndex, X 
RTS 


; Pointers To Sound Data 
DW Sndo,Sndl 
; Sound Setup Tables 


DB fe) 
DW Soundoff 
DW NoteData 
DB 1 
DW Soundoff 
DW NoteData 
DB 2 
DW Soundoff 
DW NoteData 
DB 3 
DW Soundoff 
DW NoteData 


DB SFF 

DB fe) 

DW vel 

DW NoteDatat+24 
DB 1 


DW LIKE_HAL 
DW NoteDatat+24 
DB SFF 
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STENV1 


STENV9 


ADDVceAdr2 


STENV9T 
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ORA ViAmpWave , X 
STA V1iAmpWave , X 


LDA (VceAdr2) ,Y 
BNE STENV2 


LDA #$07— 
JMP STENV1 
SEC 

SBC #1 
AND #SO0F 
ORA #$80 


STA ViSweep, xX 
LDX VceIndex 


LDA (VceAdr2),Y 
STA Attack1,X 


LDA (VceAdr2) ,Y 
STA Decayl1,X 


LDA (VceAdr2) ,Y 
STA Sustain1,X 


LDA (VceAdr2) ,Y 
STA Releasel,X 


LDA (VceAdr2) ,Y 
STA PeakVol ,X 
LDA #SFF 

STA v3cntrl 

LDA VceIndex 


TAY 
ASL A 
ASL A 
TAX 


LDA ViAmpWave, X 
STA ViShadow, Y 
LDA ViSweep,X 

STA SweepShadow, Y 
LDA #9 


ADC VceAdr2 
STA VceAdr2 


BCC STENV9J | 
INC VceAdr2+1 


DB $30,$70,$B0,$F0 
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SoundRefresh 


SndRefreshl 


SndRefresh31 


SndRefresh3 


SndRefresh9 ~ 


SndRefresh2 
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+ Main sound refresh routine 


DEC 
LDA 


W_SndTimer 
W_SndTimer 
#SFF 
SndRefresh9 
SndTimer 
W_SndTimer 
#$00 
VceIndex 


VceEnable 
BitTest,X 
SndRefresh31 
RestEnable 
BitTest,X 
SndRefresh3 
W_Duration1,X 
SndRefresh2 
GetData 
VceIndex 
VceIndex 

#4 
SndRefreshl 
LoadCntrl 


VceIndex 

#2 
SndRefresh3 
Envindex, X 
A 


ENVTAB , X 
VceAdr3 
ENVTAB+1,X 
VceAdr3+1 
VceIndex 


A 
A 


ViAmpWave, Y 
TempSound 
MNJMP 
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Voice and Command Data. 


If bit 7 is set the byte is a command byte. 
$80 = Set Envelope followed by 8 
description bytes. 

Duty Cycle = 1..3 

Amplitude = 1..15 starting amplitude 


Sweep = 0 no sweep, 1..8 down, 
9..16 up 
Attack = 0..15 rate of attack 
Decay = 0..15 rate of decay 
Sustain = 0..31 length of sustain 
after decay 
Release 0..15 rate of release 


ul 
oO 

° 

~ 
wu 


Peak Volume 

$90 = Set clicks/number of jiffies per 
duration count. 

$A0 = Quit voice, followed by S$FF. 

$BO = Rest. Rest duration is specified 
by lower nibble. 

$CO = Loop Voice. Causes a loop back to a 
specified label. Must be followed by a two 
byte loop label and a single byte loop 

count. 


If bit 7 is reset then data is actual note 
data. 
For voices 1..3: 
First byte = duration 0..15 
Second byte = pointer to frequencies. 
There may be 
256 frequencies in a frequency table. 
For voice 4: 
First byte duration 0..15 
Second byte frequency (lower nibble). 
Bit 7 specifies 
random (b7=0) or periodic (b7=1). 


DB $A0,$FF 


DB $90,$01 
DB $80,$01,$0F,$00,$03,$02,$20,$01, $0F 
DB $10,$0D,$08,$11,$08,$14,$0C,$0C 

DB $02,$0D,$02,S0F,$10,$0D 

DB SAO, $FF 


DB $80,$01,$0F,$00,$03,$02,$20,$01,S0F 
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PLOOP 


vc2 


BASSO 


HARMONY 


MELODY 


vec3 


vc4 


vcs 


LP5 
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$04,$01,$04,$08,$04,$05,$04,$08 
$co 


PLOOP 
$02 
$04,$03,$04,$08,$04,$06,$04,$08 
$04,$01,$04,$08,$04,$05,$04,$08 
SAO, $FF 


$80,$03,$0F,$00,$03,$02,$20,$01,$0F 
$02,$11,$04,$0C,$03,$0F,$04,S0E 
$02,$11,$04,$0C,$03,$0F,$0F,$0E 
$A0,SFF 


$80,$03,$02,$00,$02,$04,$20,$01, $09 
$90,$02 

$04,$09,$07,$15,$B1, $04, $15 

$co 

BASSO 

$04 


$80,$03,S0F,$00,$03,$02,$20,$01,$08 
$08,$00,$06,$02,$02,$04,$04,$02,$0C,$00 . 
$A0,$FF 


$80,$03,$0F,$00,$03,$02,$20,$01,$0F 
$08,$04,$06,$05,$02,$07,$04,$05,$0C, $04 
$A0, SFF 


$80,$02,$0F,$00,$03,$02,$20,$01,$0F 
$06,$05 

$07, $03 

$02,$05,$04,$00 

$03,$03,$0F,$02 

SA0,$FF 


$80,$02,$0F,$00,$03,$02,$20,$05,$0F 
$02,$F6,$04,$04,$03,$F7,$04, $07 
$02,$11,$04,$0C,$03,S0F,$0F,$0E 
SA0,SFF 

$90,$00 
$80,$01,$0F,$00,$03,$02,$20,$01,$0F 
$02,$05,$04,$00,$03,$03,$04,$02 
$02,$11,$04,$0C,$03,S0F,$04,$0E 

Sco 

LP5 

$07 
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DB 


$A0,SFF 


; Table of frequency values. 


SAD, $06,$4A,$06, SEF, $05 
$9B,$05,$4B,$05,$FE, $04 
$B5,$04,$73,$04,$30,$04 
SF5,$03,$BD,$03,$87,$03 
$56,$03,$25,$03,$F8, $02 
$CD,$02,$A5,$02,$7F,$02 
$5B,$02,$3A,$02,$19, $02 
$FB,$01,$DE,$01,$C3,$01 
$AA,$01,$92,$01,$7B,$01 
$66,$01,$52,$01,$3F,$01 
$2D,$01,$1C,$01,$0C,$01 
SFD,$00,$EF,$00,$E1, $00 
$D4,$00,$C9,$00,$BD, $00 
$B3,$00,$A9,$00,$9F, $00 
$96,$00,$8E,$00,$86, $00 
$7E,$00,$77,$00,$70, $00 
$6A,$00,$64,$00,$5E,$00 
$59,$00,$54,$00,$4F,$00 
$4A,$00,$47,$00,$42,$00 
$3E,$00,$3B,$00,$38,$00 
$35,$00,$31,$00,$2E,$00 
$2¢,$00,$29,$00,$27,$00 
$25,$00,$23,$00,$21,$00 
$1F,$00,$1D,$00,$1B, $00 


SFFFA 
NMIVector 


RESVector 
TROVector 


se te Me 
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NMI service routine 
Reset entry routine 
IRQ service routine 
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PPU MEMORY MAP 


$0000 


- $1FFF 


Sprite and background character set 

de.. .tions. The sprite/background sets may 
be assigned to either the upper or lower 4K 
area under program control. Both sprites and 
background characters may use the same area. 
(Memory on cartridge). 


$2000 - $23BF Screen 1 Character Memory 

$23CO - $23FF Screen 4 Color Memory 

$2400 - $27BF Screen 2 Character Memory 

$27€0 ~ $27FF Screen 2 Color Memory 

$2000 - $23BF Screen 3 Character Memory (on cartridge) 
.$23CO - $23FF Screen 3 Color Memory 

$2400 - $27BF Screen 4 Character Memory (on cartridge) 
$27CO - $27FF Screen 4 Color Memory 

CPU MEMORY MAP 

$0000 - $OOFF Page Zero Memory. 

$0100 - $01FF 6502 Stack and General Purpose Memory 
$0200 - $02FF Sprite Definition page 

$0300 - $O07FF General Purpose Memory 

$2000 PCR1 PPU control register 1. 


765432410 


MSB of horizontal scroll offset. 
MSB of vertical scroll offset. 
Memory transfer auto increment 
mode. (0) = increment by 1. 

(1) = increment by 32. 

Sprite character memory area 
start. (0) = $0000. (1) = $1000. 
Background character memory area 
start. (0) = $0000. (1) = $1000. 
(1) = double character size. 
Must be reset (0). 

NMI generation enable (1). 
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$2001 PCR2 


76543210 


$2002 


$2003 
$2004 


$2005 


$2006 


$2007 


PSTR 


PPCR 
PPAR 


PSOR - 


PMAR 


PMDR 
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PPU control register 2. 


Color mode selection. 

(0) = color. (1) = monochrome. 
Blank leftmost column of 
background display. 

Blank leftmost column of 

sprites displayed. 

Blank entire background. 

Blank all sprites. (Bits 3,4, when 
reset, allow CPU access to PPU memory) 
Control of background color DO 
Control of background color D1 
Control of background color D2 


PPU status register 

Read only register. Bit 7 set when interrupt 
has occurred. Reading this register clears 
bit 7. 


DMA page count register. 
DMA page address register. 


PPU Scrolling Register. Used to write scroll 
offset to PPU. Accessed by a 16 bit write, 
horizontal data first. 


DMA Address Register (16 bits, MSB first). 
Before communicating with PPU memory the 
starting PPU address has to be loaded into 
this register. 


DMA Data Register (bidirectional). After 
setting up PMAR successive read/writes can be 
performed with PPU memory. Note that the 
first byte read after setting up PMAR will 
always contain invalid data and should be 
ignored. 
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Background colors. 


$3F00 
$3F01 
$3F02 
$3F03 
$3F04 
$3F05 
$3F06 
$3F07 
$3F08 
$3F09 
$3FOA 
$3F0B 
$3F0Cc 
$3F0D 
$3FOE 
$3FOF 


Sprite Colors. 


$3F10 
$3F11 
$3F12 
$3F13 
$3F14 
$3F15 
$3F16 
$3F17 
$3F18 
$3F19 
$3F1A 
$3F1B 
$3F1C 
$3F1D 
$3F1E 
$3F1F 


Sound Voice 1. 


$4000 


$4001 
$4002 
- $4003 


V1R1 


V1R2 
V1R3 
V1R4 


color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 


set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 


background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 


Screen background color. 


color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 
color 


Voice 1 Duty cycle, amplitude and sound 


set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 
set 


length. 
Voice 1 frequency sweep 
Voice 1 frequency lower 8 bits. 


Voice 1 frequency upper 3 bits and actual 
sound length. : 


color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
background (not used) 

color for bit combo 01 
color for bit combo 10 
color for bit combo 11 
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é 


pots 
i 


Sound 
$4004 
$4005 
$4006 
$4007 
Sound 
$4008 
$4009 


$400A 
$400B 


Sound 
$400C 
$400D 
$400E 
$400F 
Sound 
$4010 
$4011 
$4012 
$4013 
$4014 
$4015 


$4016 


$4017 


Voice 2. 


V2R1 
V2R2 


V2R3 
V2R4 


Voice 3. 
V3R1 
V3R2 


V3R3 
V3R4 


Voice 4. 
V4R1 
V4R2 
V4R3 
V4R4 

Voice 5. 
V5R1 
V5R2 
V5R3 
V5R4 
DPNR 
VMER 


JOYIPRT 


JOY2PRT 
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Voice 2 Duty cycle, amplitude and sound 

length. 

Voice 2 frequency sweep 

Voice 2 frequency lower 8 bits. 

Voice 2 frequency upper 3 bits and actual 
sound length. 


Voice 3 sound length. 

Not Used. 

Voice 3 frequency lower 8 bits. 

Voice 3 frequency upper 3 bits and actual 
sound length. 


Voice 4 amplitude and sound length. 
Not Used. 

Voice 4 frequency range lower 4 bits. 
Voice 4 actual sound length. 


Sample clock, repeat and IRQ enable. 
Direct D/A data. 

Delta modulation address pointer. 
Delta modulation byte count. 


DMA source page #, high byte used for sprite 
parameter DMA transfer. 
Voice Master Enable Register 


Controller 1 data latch signal. Contains 
serial controller data after latch. 


Controller 2 data latch signal. Contains 
serial controller data after latch. 


$6000 - $7FFF Extra CPU Memory (option on cart) 


$8000 - $BFFF Program Memory Lower 16K (On Cart) 


$C000 - $FFFF Program Memory Upper 16K (On Cart) 
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NES CARTRIDGE EMULATOR 


The Nintendo Cartridge Emulator (NCE) was designed by the author. It is the first 
pass at creating a development system for the NES. The board consists of two dual 

orted areas of RAM which are accessible by the host as well as the NCE. 

evelopment software currently exists for an IBM AT host. The software includes a 
6502 cross assembler (XASM), a 6502 monitor (XMON), a background character 
editor (NICHED), a sprite editor and animator (NISPED), a music and sound 
effects compiler (NIMCO) and various utilities. The documentation for most of 
these programs is separate. 


The utilities include a downloader and a memory tester. For purposes of adapting 
your own development environment to an NCE board a listing of the 8088 download 
utility source code is included. Since the NCE connects to the host through a 
standard Parallel Printer Port other system may be utilized by following the code 
principles from the included source file. 
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NCE COMMUNICATIONS CODE 


Following is the 8088 code used to communicate with the NCE. 


* === SSS SSS SSS 


tes NCE Download Routines 
= Written 1/23/88 by A. Haroutunian 


u 
nneu 
% ob OF 


tk 
* 
#= These routines can be included with TURBO PASCAL 

*= Version 4.0 or above programs that communicate with 
*= the NCE~1 development board. The printer port used 

*= should be specified by the master program. To perform 
*= the read function the printer port must be modified 
*= for bidirectional communication. 

*= For specific software interface requirements refer to 
*= your TURBO PASCAL manuals. 

= SS SSS SSS SSS SS SSS SS SS SSS SS VSS SS SS SS SS SS 


+ + 


ae 2 


atau 
+ 


* 


e 
é 
e 
é 
e 
4 
e 
e 
e 
s 
e 
o 
° 
e 
e 
’ 
e 
‘ 
e 
’ 
e 
‘ 
e 
a 
e 
‘ 


DATA SEGMENT WORD PUBLIC 


EXTRN DataPort :WORD 
EXTRN CtrlPort :WORD 
EXTRN Ctrla 3: BYTE 
EXTRN Ctric 3: BYTE 


DATA ENDS 
CODE SEGMENT BYTE PUBLIC 


PUBLIC WritePRG 
PUBLIC WriteCHR 
PUBLIC ReadPRG 
PUBLIC ReadCHR 
PUBLIC NCEInit 


PUBLIC SetPHost 
PUBLIC SetPTrg1l 
PUBLIC SetPTrg2 
PUBLIC SetCHost 
PUBLIC SetcTrgl1 
PUBLIC SetCTrg2 


ASSUME CS :CODE 
CWRO EQU OAH write data to PPI port A 


CWR1 EQU OEH ? write data to PPI port B 
CWR2 EQU 02H ; write data to PPI port c 
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CWR3 
port 


CRD1 

CSELO 
CSEL1 
CSEL2 
CSEL3 


MDAOBOCO 
MDAOBICO 


RDPULSE 
WRPULSE 
LOPULSE 
HIPULSE 


PortAWrite 


PortAWrite 


PortAUpd 


PortAUpd 
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EQU 06H 

EQU 2DH 

EQU 08H 

EQU OCH 

EQU 00H 

EQU 04H 

EQU 80H 

EQU 82H 

EQU 01H 

EQU 02H 

EQU 04H 

EQU 08H 

+ Write AL to PPI 
PROC NEAR 
MOV DX, DataPort 
OUT DX,AL 
ADD DL, 2 

MOV AL, CSELO 
MOV AH, CWRO 
OUT DX, AL 
*XCHG AL, AH 
OUT DX, AL 
*XCHG AL, AH 
OUT DX, AL 
RET 

ENDP 


™e Me Ne te 


me 


write data to PPI control 


read data from port B 


=e 


select port A 
select port B 
select port C 
select control port 


~e %e te te 


all PPI ports outputs 
B input 


=e Ne 


read pulse 

write pulse 
latch low pulse 
latch high pulse 


Port A 


printer data port 
write data 
control port 

reg 0 select 

port 0 write 

do select 

; get write 

; do write 

; get select 

; do select 


se Se “ee Me Me Me 


a 


; Update port A with new value 
; BH is value mask, BL is new bit 
? 


NEAR 

AL, CtrlA 
AL, BH 

AL, BL 
CtrlA,AL 
PortAWrite 


get current port value 
mask out specific bit 
set specific bit 

save new value 

write it 


=e Se Me Ne Me 
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PortBWrite 


PortBWrite 


PortBRead 


PortBRead 


PortcCWrite 


LER ye ee ee ee ae ee ae ee ER ee 
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NEAR 
DX, DataPort 


PPI port B 


NEAR 

DX, DataPort 
DL, 2 

AL, CSEL1 
DX,AL 
AL, CRD1 
DX,AL — 
DL,2 

AL, DX 
DL, 2 

AX 

AL, CSEL1 
DX, AL 
AX 


NEAR 

DX, DataPort 
DX,AL 

DL, 2 
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=e ™e Ye Me SO We 


me 


=e 


=e "6 Me Me Ne TE Ne NEO TO Te Ve Ve NE 


e 
’ 
e 
s 
e 
’ 


printer data port 
write data 
control port 

reg 1 select 
port 1 write 

do select 

? get write 

do write 

; get select 

do select 


printer data port 
control port 
reg 1 select 
do select 
read reg 1 

do read 
printer port 
read data 
control port 
save input 
reg 1 select 
do select 
restore input 


printer data port 
write data 
control port 


Portcwrite 


PortCUpd 


PortcUpd 


PortxXwWrite 


PortxXwrite 


SelectPRG 
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MOV AL, CSEL2 ; reg 2 select 
MOV AH, CWR2 ; reg 2 write 
OUT DX,AL ; do select 
*XCHG AL,AH ? get write 
ouT BY, AL ; do write 
*XCHG AL,AH ; get select 
oUuT DX, AL 7 do select 
RET 

ENDP 


Update port C with new value 
BH is value mask, BL is new bit 


=e Me we Ne 


PROC NEAR 

MOV AL, Ctr1ic * get current port value 
AND AL, BH ; mask out specific bit 
OR AL, BL ; set specific bit 

MOV Ctr1c,AL * save new value 

JMP PortCwrite ; write it 

ENDP 

; Write AL to PPI Control Port C 
PROC NEAR 

MOV DX, DataPort ; printer data port 

OUT DX, AL ; write data 

ADD DL, 2 ; control port 

MOV AL, CSEL3 ; reg 3 select 

MOV AH, CWR3 ; reg 3 write 

OUT DX, AL ; ado select 

*XCHG AL, AH ; get write 

OUT DX, AL ; do write 

*XCHG AL,AH | ; get select 

OUT DX,AL ; do select 

RET 

ENDP 


+ Select program RAM for download 


NEAR 
BX, 7FOOH 


PROC 


MOV ; AND/OR Mask 


JMP PortAUpd ; OXXXXXXX 


SelectPRG 


SelectCHR 


SelectCHR 


SetPHost 


SetPHost 


SetPTrgl 


SetPTrgl 


SetPTrg2 


SetPtrg2 


SetCHost 


SetCHost 
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ENDP 


Select character RAM for download 


=e Se we 


PROC NEAR 

MOV BX, 7F80H ; AND/OR Mask 
JMP PortAUpd 3; 1XxxXxXxXxXxXx 
ENDP 


PROC NEAR 

MOV BX, OFCOOH ; AND/OR Mask 
JMP PortCUpd *; XxXxxxx00 
ENDP 


PROC NEAR 

MOV BX, OFCO1H ; AND/OR Mask 
JMP PortCUpd ; XXXxXxx01 
ENDP 


; Select program RAM Type 2 mode 


PROC NEAR 


MOV BX, OFCO2H ; AND/OR Mask 
JMP PortCUpd ; XXXXxXxX10 
ENDP 


Select character RAM host mode 


=e te Me 


PROC NEAR 


MOV BX, OF300H ; AND/OR Mask 

JMP PortCcUpd 7; Xxxx00xx 

ENDP 
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SetcCTrgl 


SetcTrgl 


SetcTrg2 


SetcTrg2 


SetaAd16 


SetaAd16 


ResAd16 


ResAdi6 


SetModel 


SetModel 


SetMode2 
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Select character RAM Type 1 mode 


me we 


PROC NEAR 


MOV BX, OF304H ; AND/OR Mask 
JMP PortCUpd ; ¥xxx01lxx 
ENDP 


; Select character RAM Type 2 mode 


PROC NEAR 

MOV BX, OF308H ; AND/OR Mask 
JMP PortCUpd 7 XXXxX10xx 
ENDP 


PROC NEAR 

MOV BX, 07F80H ; AND/OR Mask 
JMP PortCUpd 7; 1xXxxxxxx 
ENDP 


PROC NEAR 

MOV BX, O7FOOH ; AND/OR Mask 
JMP PortCUpd ; OXXXXXxXX 
ENDP 


? 
; Set PPI ports A/B/C to output mode 


PROC NEAR 

MOV AL, MDAOBOCO 
JMP PortxWrite 
ENDP 


Set PPI Ports A/C to ouput, B to input 


=e te Me 


PROC NEAR 
MOV AL, MDAOBICO 
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SetMode2 


DoPulse 


DoPulse 


SendAddr 


SendAddr 


NCEInit 


NCEInit 
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JMP 
ENDP 


~™e te Me NE 


7; Send download address to latches 1 and 2 
+ download address in AX 


me te Ne 


PortxWrite 


Generate a pulse on 
pulse the bit in BL 


NEAR 

AL, CtrlaA 
AL, BL 
PortAWrite 
AL, CtrlA 
PortAWrite 


NEAR 
AX 
PortBWrite 
BL, LOPULSE 
DoPulse 

AX 

AL, AH 
PortBWrite 
BL, HIPULSE 
DoPulse 


Initialize the NCE 


NEAR 
SetModel 
AL, AL 
Ctr1A,AL 
Ctr1c,AL 


port A 


=e ™e Se Se we 


~e ™e we Me we 


me se te 


° 
c 
e 
? 


get current value 
include new bit 

set new bit 

restore control value 
write out 


save address 
write LSB 

select LOW pulse 
do pulse 

restore address 

; get MSB 

write MSB 

select HIGH pulse 
do pulse 


all ports outputs 
clear control values 


WrPCount 
WrPFrom 
WrPToLo 
wrPToHi 


WritePRG 


Wpl: 
Wp2: 


WritePRG 


~e ™e Oe TO Te Me TO Re NEO 


EQU WORD PTR [BP+4] 
EQU DWORD PTR [BP+6] 
EQU WORD PTR [BP+10] 
EQU WORD PTR [BP+12] 
PROC NEAR 

PUSH BP 
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Write a block of memory to 
program RAM in the NCE. 


Header is: 


PROCEDURE WritePRG(WriteTo : LONGINT; 
WriteFrom : POINTER; 
HowMany :WORD) ; 


MOV BP,SP 

CALL SelectPRG .- 
CALL SetPHost 
MOV SI,WrPCcount 
LES DI,WrPFrom 
MOV AX, WrPToHi 


CMP AX,0 
JNE Wpl 
CALL ResAd16 
JMP Wp2 


CALL SetAdi16 

MOV AX, WrPToLo 

CALL SendAddr 

INC WrPToLo 

MOV AL, ES: [DI] 
DI 


CALL PortBWrite 


DEC SI 
INE Wp2 
POP BP 
RET 10 
ENDP 


~e Me Se Me Ne 


=e Se Se Se Se Se Ne MO Se Se Ne Ne VO Te Ne Te Te Ne Se Ne 


=e Se 


number of bytes 
source buffer adr 
dest address lo 
dest address hi 


=e "ee Se te 


select PRG RAM 

select host mode 

get number of bytes 
ES:DI = source pointer 
get high bit 


see if set C 
no 


reset address 16 
continue 

set address 16 

get target address lo 
set up address 

bump destination adr 
get byte to write 
bump source pointer 
write data 

get write pulse 

do the write 
decrement byte count 
continue if more 


restore base 
adjust stack 


Read a block of memory from 
program RAM in the NCE. 


Header is: 
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RdPCount 
RdPTo 
RdPFromLo 
RaPFromHi 


ReadPRG 


Rpl: 


Rp2: 


ReadPRG 


WrcCount 
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~e we MO NE 


“=e Se Se Se Ne Se Me Ne we 


EQU 


PROCEDURE ReadPRG(ReadFrom 


: LONGINT; 
ReadTo : POINTER; 
HowMany :WORD); 


WORD PTR [BP+4] 
DWORD PTR [BP+6] 


WORD PTR [(BP+10] 
WORD PTR [(BP+12] 


NEAR 

BP 

BP,SP 
SetPHost 
SelectPRG 
SI,RdPCount 
DI, RadPTo 

CX, RAPFromHi 
AX, RAPFromLo 
SendAddr 
RdGPFromLo 
SetMode2 
CL,0 

Rp2 

SetaAD16 
AL,CtrlA 

AL, RDPulse 
PortAWrite 
PortBRead 


SetModel 
SI 

Rpl 

BP 

10 


Header is: 
PROCEDURE WriteCHR(WriteTo 


=e Se Se Se Se Se Se Ne Te TO TE Ne TS Ne TS TE Te VE Me Te Ne WS 


number of bytes 
destination address 
source address lo 
source address hi 


me te Me VO 


select host mode 
select program RAM 
get number of bytes 
ES:DI = dest pointer 
get source hi 

get source lo 

set up address 

bump source address 
PPI port B = input 
see if upper set 

no 

set upper 

get current value 
get read pulse 

make printer port input 
read a byte 

save it 

make port B output 
decrement byte count 
continue if more 
restore base 

adjust stack 


Write a block of memory to 
character RAM in the NCE. 


:WORD; 
WriteFrom : POINTER; 
HowMany : WORD) ; 


WORD PTR (BP+4] 


; number of bytes | 


WrCFrom 
WrCTo 


WriteCHR 


Wel: 


WriteCHR 


Rdaccount 
RdCTo 
RdaCFrom 


ReadCHR 


pointer 
Rel: 
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EQU DWORD PTR [{BP+6] ; source address 
EQU WORD PTR [BP+10}] ; destination address 
PROC NEAR 

PUSH BP 

MOV BP,SP 

CALL SelectCHR ; select CHR RAM 

CALL SetCHost * select host mode 
MOV SI,WrcCount ; SI = number of bytes 
LES DI,WrCFrom ; ES:DI = source 

MOV AX, WrCTo ; destination address 
CALL SendAddr ; write it out 

INC WrCTo ; bump destination 
MOV AL,ES: (DI] ; get a source byte 
INC DI ; bump source pointer 
CALL PortBWrite ; write it 

MOV BL, WRPulse ; get write pulse 
CALL DoPulse ; do the write 

DEC SI ; decrement byte count 
JNE Wel ; continue if more 
POP BP + restore base 

RET 8 ; adjust stack 

ENDP 


Read a block of memory from 
character RAM in the NCE. 


Header is: 
PROCEDURE ReadCHR(ReadFrom :WORD; 


me te Te Te Me Me MO VS TE 


WriteTo : POINTER; 
HowMany :WORD) ; 


EQU WORD PTR [BP+4] ; number of bytes 

EQU DWORD PTR [BP+6] ; source pointer 

EQU WORD PTR [BP+10] ; destination pointer 
PROC NEAR 

PUSH BP 

MOV BP,SP 

CALL SelectCHR ; select CHR RAM 

CALL SetCHost ; select host mode 

MOV ST,RdcCount ; number of bytes to read 
LES DI,RdaCTo ; ES:DI = destination 
MOV AX, RdCFrom ; get source address 

CALL SendAddr ; write it out 
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ReadCHR 


CODE 
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RdCFrom 
SetMode2 
SelectCHR 
AL, CtrlA 
AL, RDPulse 
PortAWrite 
PortBRead 


SetModel 
SelectCHR 
SI 

Rel 

BP 

8 
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7e Se te MO NE NO We VO TO VE Ve NE Ne Te 


bump source address 
PPI port B is input 
restore char select 
get control value 
get read command 
make printer port input 
read the byte 

save it 

make port B output 
restore char select 
decrement byte count 
continue if more 
restore base 

adjust stack 


